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A DOCUMEOT ASSEMBLY SYSTEM 
FIELD OF THE INVENTION 

The present invention relates to document assembly or document automation, and in 
5 particular to a document assembly system, and methods executed by components of the 
system. 

BACKGROUND 

Document assembly refers to the generation of an instance document from one or more 
source documents. In general, a source document is a generic template document, and 

10 additional information specific to the relevant circumstances is required to generate an 
instance document from one or more source documents. This additional information can 
originate from a user and/or some other data source. Document assembly software has 
been developed for generating documents that typically contain large amounts of common 
text , or data with a smaller amount of varying detail text or data. Document assembly 

15 software is usefiil because, where a suitable source docimient exists, it enables instance 
documents to be produced more efficiently than may otherwise be the case using a 
sftandard word processor. A form letter is perhsqis the simplest and most familiar example 
of a source docimient, and can be used to generate instance letters for a number of 
recipients. An instance letter is typically generated from a single source document and 

20 addressee information, such as the addressee's first and last names, title, and address. More 
complex instance documents, such as legal or financial documents, can be generated from 
one or more source documents, based on information specific to ttie parties involved and 
the circimistances of their relationships. 

25 A source document is represented in a document assembly system in some data format. 
Common data formats (only some of which are commonly used for source docmnents for a 
document assembly system) include plain Jext, Microsoft's proprietary Microsoft Word 
"doc" format, the rich text format (RTF), portable document format (PDF), and hypertext 
markup language (HTML). A data format which is now being used for a wide variety of 
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applications is extensible markup language (XML), as described at 
http://www,w3.org/XML . An XML document combines the text of a docimient with tags 
that markup that text into logical elements. As a data format for storing documents 
generally, XML has a number of advantages over other data formats. In particular, XML 
5 can be used to markup text in a way that tags it with its meaning or purpose, and 
applications can manipulate the text on the basis of these tags. Tools for parsing and 
manipulating XML data are available from a variety of vendors. 

XML allows a document grammar to be defined which an XML document must match if it 
10 is to be said to be valid with respect to that grammar. If a document is valid, then systems 
that can handle documents matching that grammar can manipulate those documents taking 
advantage of the grammar. Such a grammar is often contained within a ^^document type 
definition" (DTD) or "XML schema". There are many different grammars for XML 
documents that are designed to meet specific needs. For example, the DocBook document 
15 type definition, documented at http://www.oasis-open.org/docbook/xml/, was designed to 
meet very general documentation requirements. 

A document assembly system preferably performs a number of basic fimctions. First, it 
determines, on the basis of data provided to it, which parts of a source docimient to include 

20 in or exclude from a resulting instance document. For example, a paragraph, sentence or 
phrase might only be included in a legal contract if there is a guarantor. Second, the system 
can also include in the instance document text which is not present in the source document. 
For example, a date, an address, or where a user of the system enters a yearly rental, the 
amoimt calculated to be payable per calendar month. In order to be able to provide these 

25 two basic fimctions, a document assembly system stores (i) information as to which parts 
of the source document may be included or excluded from the instance document, and (ii) 
information as to the locations in the document in which additional text may be inserted. 

It is also desirable to be able to repeat a passage of text a specified number of times, but 
30 with different data inserted at certain points within the passage in each repetition. This 
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requires the ability to identify the passage to be repeated, the number of tunes to repeat it, 
and the data to be inserted into each repetition. 

Existing document assembly products that work with source documents which are not 
5 XML based often encode the information described above directly in flie source document 
This is possible with XML source documents as well. The information could be stored as 
additional elements or attributes in the XML document itself. However, a serious 
difficulty with this approach is that the document will not be valid unless the grammar is 
altered to allow the inclusion of that information. 

10 

In an alternative approach, taugjit in United States Patent 6,006,242 (Poole, et al. 
"Apparatus and method for dynamically creating a documenf % entity references are 
embedded in a document instance, and a dedicated entity resolver is used during the 
document assembly process to replace the entity references with text particular to the 
15 instance dociunent. One problem with this ^proach is that the source document will not 
validate against the original grammar unless the validating parser being used uses that 
dedicated entity resolver. 

Because in each of these approaches the document no longer validates against the original 
20 grammar using a validating XML parser, the ability to manipulate the document with 3^^ 
party XML-aware ^plications is significantly curtailed. 

It is desired to provide a document assembly method and system, a method for generating 
a source document for a document assembly system, a source document for a document 
25 assembly system, a logic source for a document assembly system, and a grammar for a 
logic source for a document assembly system that ameliorate one or more of the above 
difficulties, or at least provide a usefiil alternative. 
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SUMMARY OF THE INVENTION 

In accordance with the present invention there is provided a document generation system, 
including: 

(i) a generation component for generating an XML source document by 
5 associating an initial XML document with one or more logic sources, said initial XML 

document and said XML source document both being vaUd with respect to the same 
predetermined DTD or schema; and 

(ii) an insertion component for inserting in said XML source document one or 
more assembly instructions for determining content of an instance documeiit. 

10 

The present invention also provides a method for generating an XML source document for 
a document assembly system, including: 

(i) generating said XML source document by associating an initial XML 
document with one or more logic sources, said uiitial XML documcait and said XML 

15 source document both being vaUd with respect to the same predetermined DTD or schema; 
and 

(ii) insertmg in said XML source document one or more assembly instructions 
for determining content of an instance document. 

20 The present invention also provides a docimient assembly method, including: 

accessing an XML source document including one or more assembly instructions 
and one or more logic soiurces associated with said XML source document; and 

generating an instance document on tiie basis of said XML source document and 
said logic sources, wherein said XML source document is valid with respect to a 
25 predetermined DTD or schema. 

The present invention also provides a document assembly system, including a processing 
engine for generating an instance document from at least one XML source document and 
one or more logic sources associated with said at least one XML source document, wherein 
30 said at least one XML source document is valid with respect to a predetermined DTD or 
schema. 
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The present invention also provides a document assembly system, including an editor for 
generating an XML source document by associating an initial XML document with logic 
for use in generating an instance document from said XML source document, said initial 
5 XML document and said XML source document being valid with respect to the same 
predetermined DTD or schema. 

The present invention also provides an XML source document for a document assembly 
system, said XML source document including one or more assembly instructions for 
10 determimng content of an instance document, said XML source document being valid with 
respect to a predetermined DTD or schema. 

The present invention also provides a logic source for a document assembly system, said 
logic source including one or more logic elements for determming content of an instance 
15 document from an XML source document associated with said logic source, said XML 
source document being vaUd with respect to a predetermined DTD or schema. 

BRIEF DESCRIPTION OF THE DRAWINGS 

Preferred embodiments of the present invention are hereinafter described, by way oi 
20 example only, with reference to the accompanying drawings, wherein: 
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Figure 1 is a block diagram of a preferred embodiment of a docxmient assembly 
system comiected to a remote computer system via a cormnunications network; 

Figure 2 is a block diagram of document assembly modules, standard processing 
modules, and document assembly data files of the system; 
5 Figure 3 is a block diagram showing components of an editor of the system; 

Figure 4 is a block diagram of a processing engine of the system; 

Figure 5 is a flow diagram of a document assembly process used by the system; 

Figure 6 is a screenshot of an interview screen displayed by a web browser during 
the document assembly process; 
10 Figure 7 is a screenshot of a web browser displaying an instance document in 

HTML format generated by the system; 

Figure 8 is a schematic diagram showing the relationships between a base source 
document and reusable document components referenced by the base source document; 

Figures 9 and 10 are schematic diagrams illustrating party mapping performed by 
IS the system; 

Figure 1 1 is a screenshot of a multiple choice question displayed by a web browser 
during the document assembly process; 

Figure 12 is a schematic diagram illustratiag the development of document 
assembly files using an editor of the document assembly system; and 
20 Figures 13 to 15 are screenshots of the editor during development of document 

assembly files. 

DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENT 

In this specification, a reference to a document includes a reference to entries in a file 
25 system, database or other library, which c?n be taken together to represent the document. 
A reference to a document includes a reference to a collection of documents. 

As shown in Figure 1, a document assembly system includes a server 102 having a number 
of modules 106 to 112. The document assembly system can be remotely accessed by a 
30 user of a computer system 114 via a communications network 116, such as a local area 
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network or a wide area network such as the Internet. The modules 106 to 112 of the 
document assembly system include standard processing modules 106, document assembly 
modules 108, and document assembly data files 110. The system also includes an editor 
112 for creating and editing the data files 110. As shown in Figure 2, the standard 
5 processing modules 106 include a web server (such as Apache™) 205, an HTTPD servlet 
container 216, an XML parser 206, and an XSLT engine 207. 

The document assembly modules 108 include a Java controller servlet 218, a processing 
engine 202 and a rendering ^gine 204. The Java controller servlet 218 was created using 

10 the Java Development Kit available firom Sun Microsystems®, and provides an interface 
between the other document assembly modules and the servlet container 216. A user of 
the computer system 114 can access the document assembly system using a web browser 
application executing on the computer 1 14. HTTP requests generated by the browser are 
sent over the network 1 16 and are received by the HTTPD servlet container 216. Access 

15 to the document assembly modules 108 is provided via the Java Servlet 218, which in turn 
invokes the processing engine 202 to generate an instance document on the basis of the 
document assembly data files 110. The instance document is rendered by the rendering 
engine 204 to generate a rendered document which is sent to the user's web browser via 
the Java controller Servlet 218. 

20 

The data files 110 include source documents 208, logic sources 210, document grammars 
212, and logic grammars 214. The data files 110 may also include stored response data 
215. In the described embodiment, the server 102 is a standard computer server such as a 
Sun Fire® 15K server firom Sun Microsystems® and executing a Solaris® operating 

25 system, and the processing modules 106, 108, and 112 of the document assembly system 
are implemented as soflware modules stored on hard disk storage 104 of the server 102. 
The data sources 110 are data files also stored on the hard disk storage 104. However, it 
will be apparent tiiat the modules of the document assembly system can alternatively be 
distributed over a variety of locations, and that at least part of the modules 106, 108, and 

30 112 can be alternatively implemented as dedicated hardware components such as 
application-specific integrated circuits (ASICs). 
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The document assembly system generates instance documents from one or more generic 
source documents 208 on the basis of information provided by one or more data sources. 
The data source is typically a usct of the .system, but other data sources can be used in 
addition to, or instead of, a user. In the case when a user is a data source, this information 
is provided in the form of responses to questions generated by the system on the basis of 
information contained in logic sources 210. The document assembly system uses XML as 
the data format for representing source documents 208 and logic sources 210. In addition 
to elements used for structuring data, XML defines a comment and a processing instruction 
(PI). A processing instruction is not part of a document's usual character data, but is 
instead passed through to an application. Thus a processing instraction can be included in 
a document without affecting its validity. The form of a PI can be represented as follows: 

PI ::= •<?'PITarget(S(aiar*- (Char* 7>' Char*)))? 
The information in the processing instraction is not itself checked by a parser at all (apart 
from ensuring it begins with a string PITarget, used to identify liie target application for 
the PI). Moreover, processing instmctions can be placed anywhere in an XML document. 
The document assembly system uses Pis .to separate logic used to generate an instance 
document from the source document itself. A source docum^it 208 includes references to 
external logic sources 210 that are required to resolve the logic contained in the source 
document 208 itself. 

A source document 208 is a structured XML document, usually including one or more 
processing instractions, as described above. Some of these processing instmctions include 
logic components that are used to determine the content of instance documents generated 
from the source document 208. The logic in a source document 208 is resolved using logic 
from one or more external logic sources 210. A logic source required by a soiirce 
document 208 is identified by a reference (in the form of a universal resource indicator 
(URT)) in a processing instruction. The logic sources 210 are themselves stmctured XML 
documents that define questions, conditions, and reusable text objects. The processing 
engine 202 uses the XML parser 206 to read source documents 208 and logic sources 210. 
A logic source 210 can include one or more references to other logic source documents 
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210. The source documents 208 are described by document grammars 212, against which 
the source documents 208 can be validated. Similarly, the logic sources 210 can be 
validated against logic grammars 214. 

5 The processing engine 202 resolves logic associated with an XML source document 208. 
When a user of the system is used as a data.source, the logic is resolved by perforaiing one 
or more question and answer interview rounds that determuie which components and text 
from the source documents 208, referenced logic sources 210 and user responses are 
included in the resulting instance document. 

10 

A logic source includes XML elements that are used to determine values for variables 
required by a source document or other logic source referring to that logic source. These 
variable values are usually determined from responses provided by a user of the system in 
response to questions defined in one or more logic sources 210 referenced by the source 

15 document, either directly or indirectly via a chain of references. The process of displaying 
questions to the user and receiving responses to those questions is referred to as an 
interview, and the data defining these questions and possible responses to them is referred 
to as interview data. A given set of responses to a set of questions can be stored as stored 
response data 215 on the hard disk 104 of the document assembly system. The user's 

20 responses are used to assign values to variables, such as setting Boolean variables to a 
value of true or false for determining whether an associated portion of text is to be 
included in a generated instance document. These variables values are referred to as 
assembly data. 

25 During the course of resolving all the logic necessary for the rendering engine 204 to be 
able to render an instance document, die processing engine 202 may modify a document 
object model ODOM) representation of the source XML document 208, for example, by 
physically including XML firagments to which the source XML document 208 refers. 

30 After the processing engme 202 has resolved all the logic necessary for the rendering 
engine 204 to be able to render the instance document in a form suitable for viewing by 
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humans, the rendering engine 204 transforms the source XML document (as modified by 
the processing engine 202), omitting elements subject to an inclusion condition found to be 
false, and including responses to questions where appropriate into the desired instance 
format hiitially, the rendering engine 204 generates an HTML rendering of the instance 
5 document that includes controls for further processing of the document. Once an instance 
docimient has been finalised, the rendering engine 204 is used to generate a final rendering 
of the instance document, as described below. 

It will be apparent that in order to generate an instance document in the format requested 
10 by the user (other than XML), it is not necessary to first generate an instance document in 
XML that is valid with respect to the same grammar as the source XML document. For 
desired instance formats other than XML (XML that is valid against the same grammar as 
the source XML document), the source XML document (as modified by the processing 
engine 202) is transformed by the rendering engine 204 into the desired instance format via 
15 several mtermediate XML formats. During flie course of those transformations, die 
processing instructions are replaced as s^propriate with the information obtained during 
the interview process. 

In an alternative embodiment, the processing engine 202 generates an instance XML 
20 document (using the same grammar as the source document or a similar one) for the 
rendering engine 204. In yet a further alternative embodiment, the generation of that 
instance XML docxunent is an early step performed by the rendering engine 204 in the 
course of generating the instance document in the format desired by the user. 

25 Source documents 208 and logic sources 210 are created and maintained using the editor 
112, as shown in Figure 3, In the described embodimmt, the editor 112 is shown as being 
stored locally on the server 102. However, it will be apparent that the editor 112 can 
alternatively be stored and executed on a remotely located compute system and used to 
edit document assembly files at that location, providing that the resulting files are 

30 accessible by the parser 206 and processing engine 202 of the system. The editor 112 
includes a user interface module 302, an XML editor module 304, a validation module 
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306, and a logic module 308. The user interface 302 and XML editor 304 modules allow a 
usCT of the document assembly system to add, modify, or delete XML elements, attributes, 
coimnents, processing instmctions, and text The XML editor module 304 provides 
standard XML editor functions plus the ability to add and manipulate condition references, 
5 reusable text, user text, notes, and meta-infonnation processing instructions around and 
within document components. If a processing instruction having some other pxirpose is 
added to the system, the XML editor modxUe 304 is altered to add and manipulate that sort 
of processing instruction as well. 

10 The validation module 306 provides standard XML document validation, as well as logic 
source validation, and validation of interactions between source XML documents 208 and 
logic sources 210. The logic module 308 allows the user to define and manipulate 
questions, conditions and reusable text It also allows the user to define parameter values 
that are used to determine default answer to questions, as described below. The editor 1 12 

15 allows a user to define and manipulate logic within the logic sources 210, manipulate XML 
documents 208, and add logic references to a logic source 210 within an XML document 
208. The editor 112 parses XML elements using the XML parser 206. The editor 1 12 uses 
the document grammars 212 and logic grammars 214 to determine which elements can be 
added and deleted, and how they can be manipulated. Grammars are also used as a basis 

20 for detemiining what types of logic can be added. For example, reusable text can only be 
added to elements that are allowed to contain text. 

The processing engine 202 is coded in the~ object-oriented programming language Java. 
The Java language specification defines the notion of a package. As shown in Figure 4, 
25 the processing engine 202 includes an Evaluator 402, an evaluable node package 404, a 
parties package 406, an interview items package 408, and a logic sources package 410. 

The evaluable node package 404 contains classes that represent a Condition and the 
various elements that are allowed within a Condition And, Or, Not, Test and 

30 UseCondition). Each of these implement an interface called EvaluableNode. That 
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interface defines an evaluate method that can be invoked in order to determine whether the 
value of the evaluable node is true or false. 

The parties package 406 contains a class that represents a Party "known" to the source 
5 document, a Parties class that represents all known parties, and a class that represents a 
PartyDetail. 

The interview items package 408 contains classes that represent the questions which the 
evaluator module 402 has encountered, and any responses that may have been provided or, 
10 for non-"key" questions, generated automatically. These include MultipleChoiceQuestions 
referred to in a Test, UserTextQuestions, and interview items encountered in an 
ArrayRowIterator. 

The logic sources package 410 represents each logic source used directly or indirectly by 
15 the source document, and their contents, so that when a reference to a piece of logic is 
encountered, the logic can be retrieved efficiently. 

The evaluator module 402 is the collection of classes that orchestrate the evaluation of the 
source document. It controls the evaluation processing, represents the state of the 
20 evaluation and calls the packages described above as necessary. 

The rendering engine 204 includes an XSLT module which is used for transforming XML 
documents, a collection of XSL transformations, and several Xalan extensions which are 
used to manipulate objects referenced by the processing engine 202's evaluator module. 
25 XSLT and Xalan are available and documented at http://xml.apache.org/xalan-i/ . 

The processing engine 202 begins processing an input XML document 208 when its 
invocation API is called by an invoking process 412. Li the preferred embodiment, the 
invoking process 412 is the Java controller servlet 218 which invokes the processing 
30 engine 202 in response to a request firom the user's web browser passed to it firom the 
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HTTPD servlet container 216. However, lhe processing engine 202 can alternatively 
respond to requests fix>m othw applications or a Web service. 

The invoking process 412 asks the evaluator module 402 to evaluate the source document. 
5 While there are interview items for which the evaluator module 402 currently needs a 
response, the evaluator module 402 returns tiiose interview items to the invoking process 
412. It is the responsibility of the invoking process 412 to obtain a response for each of 
those interview items via some Interviewltem Resolution Mechanism 414. In the preferred 
embodiment, the Interview Item Resolution Mechanism usually renders those interview 

10 items as inputs on an HTML form sent to the user's web browser, although in some cases it 
resolves the biterview item in some other way, for example via a query to a database, or by 
invoking a web service. In such cases, an Other Sources module 416 provides an interface 
to data sources such as databases, file systOTis, web services, directory services, and so on. 
The invoking process 412 then passes the interview items, together with their responses, 

1 5 back to the evaluator module 402. 

Figure 5 shows the steps followed when creating an instance document firom a source 
XML document using a web browser executing on the user's computer 114. At step 502, 
the user selects a suitable source XML documait firom the repository of documents 208 

20 stored on the document assembly system. At step 504, the user answers setup questions for 
one or more subsequent question or interview roxmds. This includes specifying whether 
the user wants to be asked all questions during subsequent interviews, or just the "key** 
questions, in which case the system executes a scoring procedure, discussed below, to 
answer the non-^'ke/' questions with the response having the highest score. If there is more 

25 than one Party used in the source XML document, fiien the user can specify which of the 
parties the user wishes to favour. This is used during subsequent interview roimds to select 
default responses that suit the selected party, and is also used by the scoring procedure that 
the system uses to answer questions itself At step 506, successive rounds of interview 
questions are presented to the user until all the questions that need to be answered in ord^ 

30 for file system to generate an instance document have been answered. The system uses 
multiple rounds of interviews in order to limit the number of questions asked to those 
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necessary for a particular situation. In some documents, legal documents, it may not 
be possible to determine whether a particular question needs to be asked until answers 
have been provided for several other questions. The system tiierefore asks the necessary 
questions in a series of interview roimds, with the questions for a particular interview 
5 round determined from answers provided in one or more previous rounds. 

As described above, the interview rounds are used to determine values for variables used 
by the source document and/or referenced logic sources, and these variables determine 
content of the resulting instance docimient. In the general case, where some or all variables 
10 are resolved from data sources other than a user, the variables are resolved at step 506, as 
described below, until the system is able to generate an instance document. 

Variables that can be resolved without user input are resolved by the processmg 
engine 202 from other data sources. The processing engine 202 provides the questions to 
1 5 which it requires req)onses to the Java controller servlet 218. It is the responsibility of that 
servlet 218 to return the responses to the processing engme 202. Where the questions are 
put to a user via their web browser, the controller servlet 218 can put all the questions to 
the user in a single HTML form, or it can put the questions to the user one at a time, or it 
can group them by topic, asking the questions in a single topic in a given form. 

20 

For example. Figure 6 is a screenshot of a web browser display during an interview round 
for generating an instance document that is a letter of employment for a prospective 
employee. The display includes two questions for the user. The first is related to the 
employee's expected work hours. A shaded area 602 displays a question presented to the 

25 user in a previous interview round, togetiier with the user's response. The question asked 
was whether the employer permits flexible working hours in relation to the employee. 
Because the answer previously provided was in flie affirmative, subsequent questions 604 
are displayed to the user in order to determine the nature of this flexibility. In this example, 
the questions are to determine the employer's normal office homrs and the core working 

30 hours in which the employee is expected to be present. The user enters the appropriate 
answers in text boxes 606 displayed under each question 604. 
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In response to the user selecting a button 608 labelled ^'nexf the processing engine 202 
determines, at step 506, whether there are further questions. If there are no further 
questions, flie rendering engine 204 generates at step 510 an instance document in HTML 
5 format on flie basis of req)onses provided by the user, and the instance document is then 
displayed by the web browser, as shown in Figure 7, 

The parts of the text that are dependent on answers provided by the user are provided as 
hypertext anchors 702, allowing the user to view the questions and responses that resulted 

10 in the insertion of that text in a popup window 704 by moving their mouse over the text. H, 
at step 512, the user selects the hypertext anchor 702, the processing engme 202 generates 
a new interview round including the relevant question, allowing the user to provide a 
different response to that question. Questions dependent on the new response are then 
presented to the user at step 506 until the processing engine 202 determines that all the 

15 necessary information has been provided. A new HTML rendering of the instance XML 
document is then generated at step 5 10 and displayed by the web browser. 

When the user is satisfied with the instance document, one of a number of buttons included 
near the top of the HTML instance document can be selected to generate an output 

20 document. The button selected determines the format of the output format. For example. 
Figure 7 shows a button 706 for creating an output document in the Adobe® portable 
document format (PDF). However, the document can alternatively generated in HTML 
(without controls), XML, or in rich text format (RTF). Check boxes 708 are also provided 
in order to allow the user to determine the content of the output document, whether it will 

25 contain the instance docxmient text, editorial notes pertaining to the use of the document, 
and/or the interview questions and answers on which the document was based. A further 
check box 710 allows the user to select whether the output document will be write 
protected. 

30 Controls 712 are also provided for storing resfponses on the system as stored response data 
215 and for applying stored responses to "the source document they came from, or to 
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anofher source document that uses some of the same logic sources, and for processing 
groups of related documents. 

It is useful to be able to store the response data, so that if a user wishes to modify some of 
5 the answers they have given in an earlier session, they can start by applying the stored 
response data to the source document, rather^than having to answer all the questions again 
themselves. When an answer file containing stored response data is loaded, the questions 
and answers are displayed to the user in an HTML form. After the user has modified the 
responses as appropriate, and submitted the forai (by selecting a "next" button), those 
10 interview items are provided to the evaluator module 402. When, in the course of 

evaluating the source document to which those answers are being applied, an interview 
item is encountered, there will be no need to ask the Java controller servlet 218 for a 
response to that item, if the response has already been provided via the answer file 
mechanism. 

15 

In a similar way, the Java controller servlet 218 can invoke the processing engine 202, 
applying a collection of response data to tiie several source documents comprising a group 
of related documents, and then invoke the rendering engine 204 to display the resulting 
instance docmnents in the user's browser, or save tiiem to disk. It will be apparent that 
20 whether each docxmient is processed then rendered, or all documents are processed then all 
rendered, depends on the controller servlet implementation (/.e., how it invokes die 
processing engine 202 and the rendering engine 204). 

Thus the document assembly system provides an efiQcient, yet flexible means to generate 
25 and modify instance documents for different circimistances. The source documents 208, 
document grammars 212, logic sources 210 and logic grammars 214 are typically created 
and maintained by an administrator of the system in accordance with the needs of the 
system's users. For example, a legal firm will create precedents for particular 
circumstances, e,g,, contracts, as source documents 208, together with their associated 
30 logic sources 210 and grammars 212, 214. The creation and maintenance of these files 110 
is performed using the editor 112. The actual assembly of these files 110 into instance 
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documents is initiated by end-users of the system accessing the system using a web 
browser. 



The document assembly system is described in more detail below with reference to 
5 examples of the data files 110 used by the system. An XML source document used by the 
document assembly system for generating instance letters is presented below in its entirety. 
Portions of this source document are then described in detail to illustrate various features 
of the document assembly system. 



10 <?xml version="1 .0" encoding="UTF-8"?> 

<!DOCTYPE Letter SYSTEM "file:///home/speedlegal/dtd/xhtmMetter/dtd/xhtmHetter- 

v2.dtd"> 

<Letler> 

<?SpeedLegal 
15 <LogicSources> 

<LogicSource ID="LogicSource_1" uri=7files/logic/LS1WD.Igc7> 
<LogicSource ID="LogicSource_2" uri=7files/logic/LS2WD.Igc"> 
<PartyMapping> 

<PartyMap From="Contractor" To="Employee"> 
20 <PartyDetailMap From="Shortname" To="Firstname"/> 

<PartyDetailMap From="Fullname" To="Flrstname7> 
</PartyMap> 
</PartyMapping> 
</LogicSource> 
25 </LogicSources> 
?> 

<?SpeedLegal 

<Meta Inf ormation> 

<rdf:RDF xmlns:dc="http://purl;org/dc/elements/1 .1/" 
30 xmlns:rd1^"http://www.w3.org/TR/WD-rdf-syntax-ns#''> 
<rdf:Description> 
<Metadata> 

<dc:Type Genesis="Original" Statuss'^Unapproved" 
Use="Precedent7> 
35 <dc:Title>Letler template</dc:Title> 

<dc:Description>Template business letter</dc:Description> 

<dc:Subject><Keyword>Letter</Keyword></dc:Subject> 

<dc:Creator> 

<Name>SpeedLegal</Name> 
40 <Organisation>SpeedLegal</Organisation> 

<md - ContactDetails> 

<md.Address>Level 4, 85 Queen Street, Melbourne, 

Victoria</md . Address> 

<md.Phone>+61 3 9670 0141</mdPhone> 
45 <md.Email>lnfo@speedlegaLcom</md.Email> 
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<md.Fax>+61 3 9670 0142</md.Fax> 
</md.ContactDetails> 
</dc:Creator> 
<RevisionHistory> 

5 

<Revislon><dc:Contributor><Name>SpeedLegal</Name><Organisation>SpeedLeg 
al</Organisation><md.ContactDetails><md.Address>Level 4, 85 Queen Street, 
Melbourne, Victoria</md.Address><md.Phone>+61 3 9670 

0141 </mdPhone><md.Eniail>info@speedlegal.conri</md.Enriail><nid,Fax>+61 3 9670 
10 0142</md.Fax></md.ContactDetails></dc:Contributor><dc:Date>6/2/2002 

1 3:49</dc:Date><What ChangeType="BrandNeW>Letter creation</What></Revision> 
</RevisionHistory> 
</Metadata> 
</rdf : Description> 
15 </rdf:RDF> 

</Metalnformation> 

?> 

<LetterHead> 
<Date/> 
20 <Salutation/> 
</LetterHead> 
<LetterBody> 
<p> 

<?SpeedLegal 

25 <Condition IDREF="PaidLeave" LogicSource="LogicSource_17> 

?> 

<?SpeedLegal 

<PartyReference IDREF="Employee" LoglcSource="LogicSource_r 
Style="Pronoun" Type="PartyDetaiM "/> 
30 ?> shall be eligible for paid leave.</p> 

<P> 

<?SpeedLegal 

<Notes> 

<Note Completionlnstruction="false" ShowExternalUsers="false" 
35 UserLevel="Non-Specialist"> 

<NoteTitle>Pald and Unpaid Leave</NoteTitle> 
<NoteBody><p>AII ennployees can request <b>unpaid</b> 
leave</p><p>Only <b>Fu[l-time</b> or <b>Part-time</b> employees who have 
accrued leave can request <b>paid</b> leave.</p></NoteBody> 
40 </Note> 
</Notes> 

?> 

<?SpeedLegal 

<PartyReference IDREF="Employee" LogicSource="LogicSource_1" 
45 Style="Firstname" Type="PartyDetaiLO"/> 

?> may request <?SpeedLegal <lnsertReusablePhrase 
IDREF="PaidOrUnpaidLeave" LogicSource="LogicSource_l7>?> by filling in a request 
fonm at least one month prior to the earliest date required.</p> 
<P> 
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<?SpeedLegal <Conclition IDREF="AmountOfLeave.negotiate" 
LogicSource="LogicSource_r7>?>The amount of leave is negotiated with the 

employee.</p> 
<p> 

5 <?SpeedLegal <Condltion IDREF="AmountOfLeave.award" 

LogicSource="LoglcSource_17>?>The amount of leave Is detemnined according to the 
relevant award.</p> 

<p>The employee has the following leave entitlements: <object> 
<table> 

10 <tbody> 

<tr> 

<?SpeedLegal <ArrayRowlterator 
repeat="NumberOfLeaveTypes7>?> 

<td><?SpeedLegal <ArrayReference IDREF="LeaveType"/>?> 

15 </td> 

<td><?SpeedLegal <ArrayReference 
IDREF="LeaveAmount7>?> 
</td> 

</tr> 

20 </tbody> 
</table> 
</object> 
</p> 

<?SpeedLegal 

25 <SmartModuIe uri=7home/jml/temiination,sm"> 

<PartyMapping> 

<PartyMap From="Contractor" To="Emp!oyee"> 

<PartyDetailMap From="Shortname" To="Firstname7> 
<PartyDetailMap From="Fullname" To="Firstname7> 
30 </PartyMap> 
</PartyMapping> 
: </SmartModuIe> 
?> 

</LetterBody> 
35 <LetterTail> 
<Closing/> 
<Sender/> 
</LetterTai!> 
</Letter> 

40 

This source document includes several processing instructions (Pis) that begin with 
"<?SpeedLegal" and end witii "?>". The data within the processing instruction, f.e., between 
these two strings, resembles one or more XML elements. This allows an application to 
45 receive the data and parse it as XML, with the various benejSts which that entails. It will 
be apparent to the skilled addressee that this structure is in conflict with the XSLT 1.0 
specification, which specifically prohibits an XSLT processor firom constructing PI data in 
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this form. In what follows, it is convenient to refer to the PI data as if it were an XML 
element 



Some of the Pis in the above source docmnent include within them a LogicSource XML 

5 element whose purpose is to specify the location or locations, outside of the source XML 

document itself, where the system can find the material necessary to process other 

processing instructions encoimtered within the docimient, such as tibie Condition instruction 

in the above example. For example, a logic source is identified in the above example as 

follows: 

10 <LogicSources> 

<LogicSource ID="LogicSource_r uri="/files/logic/LS1WD.Igc7> 

The LogicSource sub-element of the LogicSources element specifies a universal resource 
indicator (URI) at which ttie corresponding logic source can be foimd, and assigns an ID 

15 reference name to it. Many of the processing instructions throughout the example source 
document above contain an IDREF reference to one of the ID reference names of the Usted 
logic sources, which is used to identify the URI of the corresponding logic source. Thus 
the first logic source referred to in the XML docxmient is located at the URI 
"/fiies/logic/LS1 WD.Igc" and is referred to at other places in the source document by the ID 

20 reference "LoglcSource_1 This logic source is provided below. 



<?xml version="1,0" encoding="UTF-.8"?> 

<IDOCTYPE LogicFlle PUBLIC "-//SpeedLegal/ZSpeedLegal Logic for SmartEditor 
1 V0//EN" "/home/speedlegal/dtd/logic.dtd"> 
25 <LoglcFile> 

<Metalnformation> 
<rdf:RDF> 

<rdf:Description> 
<Metadata> 

30 <dc:Type Genesis="Original" Status="Unapproved" Use="Precedent"/> 

<dc:Title>D</dc:TitIe> 
<dc:Description>D</dc:Description> 
<dc:Subjecl> 

<Keyword>D</Keyword> 
35 </dc:Subject> 

<dG:Creator> 

<Nanfie>SpeedLegal</Name> 

<Organisation>SpeedLegal</Organisation> 

<md.ContactDetails> 



wo 03/075191 



PCT/AU03/00253 



-21- 



<md.Address>Level 4, 85 Queen Street, Melbourne, 
Victoria</md.Address> 

<md.Phone>+61 3 9670 0141</md.Phone> 
<md.Email>info@speedlegaLcom</md.Email> 
<md.Fax>+61 3 9670 0142</md.Fax> 
</md.ContactDetails> 
</dc:Creator> 
<RevisionHistory> 
<Revision> 

<dc:Contributor> 

<Name>SpeedLegal</Name> 

<Organisation>SpeedLegaI</Organisation> 

<md.ContactDetails> 

<md.Address>Level 4, 85 Queen Street, Melbourne, 

Vlctoria</md.Address> 

<md.Phone>+61 3 9670 0141</md.Phone> 
<md.Ennail>lnfo@speedlegal.com</md.Email> 
<md.Fax>+61 3 9670 0142</md.Fax> 
</md .ContactDetails> 
</dc:Contributor> 

<dc:Date>5/2/2002 11:4</dc:Date> 
<What ChangeType="BrandNew"> metadata</What> 
</Revision> 
</RevisionHlstory> 
</Metadata> 
</rdf:Description> 
</rdf:RDF> 
</Metalnfomnation> 
<PartiesSetup> 

<Party Assessable="true" ID="Employee"> 
<DisplayName>Employee</DisplayName> 
<Role>The person to be offered a position under this letter.</Role> 
<ParlyDetails> 

<PartyDetail ID="PartyDetaiLO" Name="Firstname"> 
<Value Gender="Unspecified" Number="Unspeclfied"> 

<lnsertUserText IDREF="EmployeeFirstname7> 
<A/aIue> 
</PartyDetail> 

<PartyDetail ID="PartyDetaiM" Name="Pronoun"> 

<Value Gender="Unspecified" Number="Singular">He<A/alue> 
<Value Gender="Female" Number="Singular">She<A/alue> 
<Value Gender="Unspecifled" Number="Plural">They<A/alue> 
</PartyDetail> 
</PartyDetails> 
</Party> 

<Party Assessable="true" ID="Employer"> 
<DisplayName>Employer</DisplayName> 

<Role>The person who will offer to engage the employee under this 
letter.</Role> 

<PartyDetails> 

<PartyDetall ID="PartyDetaiL2" Name="Name"> 
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<Value Gender="Unspedfied" 
Numbep="Unspecified">SpeedLegal<A/alue> 
</PartyDetail> 
</PartyDetails> 
5 </Party> 

</PartiesSetup> 

<LogicSources/> 

<LogicSetup> 

<UserTextQuestion Columns="20" ID="LetterSubject" Rows="r Type=Text"> 
10 <Question>What is the subject of this letter?<;/Question> 

<TopioSubject of Letter</Topic> 
</UserTextQuestion> 

<MultipleChoiceQuestion ID="EmpIoyment_type"> 
<QuestionType KeyQuestion="true7> 
15 <Questfon>On what basis will <PartyReference IDREF="Employee" 

Style="Firstname" Type="PartyDetaiL07> be employed?</Question> 
<TopioPosition and duties</Topio 

<SelectlonRu!es AnswerUsing="Defauir Cardinalltys^Slngle" 
Device="Checkbox7> 
20 <Responses> 
<Response> 

<SelectionCriteria Default="Checked7> 
<Prompt>On a full time basis</Prompt> 
<SetValueTo>FulITIme</SetValueTo> 
25 <Notes> 

<Note Completionlnstructlon="false" ShowExternalUsers="faIse" 
UserLevel="Non-Specialisf'> 

<NoteTitle>Full Time Employees</NoteTitle> 
<NoteBody> 

30 <p>Full time employees are required to work at least the 

hours specified in the award</p> 

<p>They are elligible for maternity/paternity leave as well as 

annual and sick leave</p> 

</NoteBody> 
35 </Note> 

</Notes> 
</Response> 
<Response> 

<SelectionCriteria Default="Unchecked"/> 
40 <Prompt>On a part time basis</Prompt> 

<SetValueTo>PartTime</SetValueTo> 
</Response> 
<Response> 

<SelectionCriteria Default="Unchecked7> 
45 <Prompt>On a casual basls</Prompt> 

<SetValueTo>Casual</SetValueTo> 
</Response> 
</Responses> 
</MultipleChoiceQuestion> 
50 <Condition ID="EmploymentJype:FullTime"> 

<Test IDREF="EmploymentJype" Value="Fuimme7> 
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</Condition> 

<Condition ID="EmploymentJype.PartTinne"> 

<Test IDREF="EmploymentJype" Value="PartTime7> 
</Condition> 

<Condition ID="EmploymentJype.Casual"> 

<Test IDREF="EmploymentJype" Value="Casual7> 
</Condition> 

<UserTextQuestion Columns="20" ID="Commencement" Rows="r 
Type="Text"> 

<Question>On what date will <ParlyReference IDREF="Employee" 
Style="Firstname" Type="PartyDetalLO'V>&apos;s employment 
commence?</Question> 

<TopioPosition</Topfc> 
</UserTextQuestion> 

<UserTextQuestion Co!umns="20" ID="NumberOfLeaveTypes" Rows="r 
Type="Positivelnteger"> 

<Question>How many distinct types of leave is the employee entitled 
to?</Question> 

<TopioLeave Tab!e</Topic> 
</UserTextQuestjon> 

<UserTextQuestion Columns="20" ID="LeaveType" Rows="r Type="Te)cl"> 

<Question>Type of Leave?</Question> 

<Topic>Leave TabIe</Topic> 
</UserTextQuestion> 

<UserTextQuestion Co!umns="20" ID="LeaveAmount" Rows="1" Type='Text"> 

<Question>Number of Weeks?</Question> 

<TopioLeave Table</Toplo 
</UserTextQuestion> 
<Condition ID="PaidLeave"> 

<Or> 

<UseCondition IDREF="Employment_type.FullTlme7> 
<UseCondltion IDREF="Employment_type.PartTime7> 
</Or> 
</Condition> 

<UserTe)ctQuestion Columns="20" ID="EmployeeFirstname" Rows="1" 
Type='Text"> 

<Question>Please type the <PartyReference IDREF="Employee" 
Style="Firstname" Type="PartyDetaiL07>&apos;s first name</Questlon> 
<Topic>EmpIoyee Setup</Topio 
</UserTextQuestion> 

<ReusablePhrase ID="PaidOrUnpaidLeave">unpaid <ConditionalPhrase 
Condition="PaidLeave">or pald</ConditionalPhrase> leave</ReusablePhrase> 
<MultipleChoiceQuestion I D="AmountOf Leave"> 
<QuestionType KeyQuestion="false7> 

<Question>How much leave is <PartyReference IDREF="Employee" 
Style="Firstname" Type="PartyDetaiL07> entitled to?</Question> 
<TopioSetup</TopiO 

<Se!ectionRules AnswerUsing="Bias" Cardinality="Single'' 
Device="Checkbox7> 
<Responses> 
<Response> 
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<SelectionCriteria Default="Unchecked"> 

• <ParlyAssessment Assessment="Best" IDREF="Employer"7> 
</SeleclionCriteria> 

<Prompt>Award entitlements</Prompt> 
5 <SetValueTo>award</SetVaIueTo> 
</Response> 
<Response> 

<SelectionCriteria Default="Unchecked"> 

<PartyAssessment Assessment="Worsf IDREF="Employer/> 
10 </SelectionCriteria> 

<Prompt>By negotiation with <PartyReference IDREF="Emp!oyer" 
Style="Name" Type="ParlyDetalL27> 
</Prompt> 

<SetValueTo>negotiate</SetValueTo> 
15 </Response> 
</Responses> 
</MultipleChoiceQuestion> 
<Condition ID="AmountOfLeave.award"> 

<Test IDREF="AmountOfLeave" Value="award7> 
20 </Condition> 

<Condltion ID="AmountOfLeave.negotiate"> 

<Test IDREF="AmountOfLeave" Value="negotlate7> 
</Condition> 
</LogicSetup> 
25 </LogicFile> 

Because the infoimation necessary to process processing instructions encountCTed within 
the source document are stored outside the source document, this information can be stored 
in an XML format and can tiderefore be validated against an XML schema or DTD. The 
30 DTD used by the document assembly system for validating logic sources 210 is as follows: 

<!ELEMENT LogicFile (Metalnformation^PartiesSetup, LoglcSources, LogicSetup)> 



35 <!ELEMENT LoglcSources (LogicSource)*> 
<!ELEMENT LogicSource (PartyMapping)> 
<!ATTLIST LogicSource 
uri CDATA#REQUIRED 

> 

40 <!ELEMENT PartyMapping (Partyl\/lap*)> 
<!ELEMENT PartyMap (PartyDetailMap)+> 
<!ATTLIST PartyiVlap 

From NMTOKEN #REQUIRED 

To ID #REQUIRED 

45 > 

<1ELEMENT PartyDetailMap EMPTY> 
<!ATTLIST PartyDetailMap 

From NMTOKEN #REQUIRED 
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To ID #REQUIRED 

> 

<!ENTITY % HtmlParagraphMarkup "b | i | a "> 
5 <!ENTITY % MappablePCDATA "(#PCDATA | PartyReference)*"> 

<!ENTITY % SmartsPhraseLevelDeclarations " ReusablePhrase | UserTextQuestion "> 
<!ENTITY % SmartsPhraseLevellnsertions "| InsertReusablePhrase | 
ConditionalPhrase | lnsertUserText"> 

<!ENTITY % SmartsConditions " Condition IDREF #I!VIPLIED "> 
10 <!ENTITY % SmartsldRequired "ID ID #REQUIRED"> 
<!ENTITY % Smartsldlmplied "ID ID #IMPLIED"> 
<IENTITY % SmartslDREF "IDREF IDREF #REQUIRED "> 
<!ENTITY % SmartlDREF "IDREF IDREF #REQUIRED "> 

<IENTITY % SmartsPCDATA "(#PCDATA | InsertUserText | InsertReusablePhrase | 
15 ConditionalPhrase )*"> 

<IELEMENT Metalnfomnation (rdf:RDF)> 
<!ELEMENT rdftRDF (rdf:Descriptlon)> 
<!ATTLIST rdftRDF 

20 xmlns:rdf CDATA #FIXED "http://www.w3.org^lWD-rdf-syntax-ns#" 

xmlns:dc CDATA #FIXED "http://purl.org/dc^elements/1.iy" 

> 

<IELEMENT rdf:Description (Metadata)> 

<IELEMENT Metadata (dc:Type, dcrTitle, dc:Source?, dcDescription, dc:Subject. 
25 dc:Creator, dc: Publisher?, dG:Relation*, RevisionHistory, PlannedEnhancements?)> 
<!ELEMENT dc:Type EMPTY> 

<IATTLIST dciType 

Genesis (Original | Copy | Linl<) "Originar 
30 Use (Precedent | Transaction) "Precedent" 

Status (Unapproved | Approved) "Unapproved" 

> 

<IELEMENT dc:Tltle (#PCDATA)> 
<!ELEI\/IENT dctSource (#PCDATA)> 
35 <!ELEMENT dc: Description (#PCDATA)> 
<!ELEMENT dc:Subject (Keyword*)> 
<!ELEMENT Keyword (#PCDATA)> 

<IELEMENT dc:Creator (Name, Organisation, md.ContactDetails)> 

<!ELEMENT Name (#PCDATA)> 
40 <!ELEMENT Organisation (#PCDATA)> 

OELEMENT md.ContactDetails (md.Address | md.Phone | md.Email | md.Fax)+> 

<!ELEMENT md.Address (#PCDATA)> 

<!ELEMENT md.Phone (#PCDATA)> 

<!ELEMENT md.Email (#PCDATA)> 
45 <IELEMENT md.Fax (#PCDATA)> 

<!ELEMENT dc:Publisher (Name, Organisation, md.ContactDetails)> 

<! ELEMENT dc:Relation (UsedBy?, MatterNumber?. Client?, Other*)> 

<!ELEMENT UsedBy (#PCDATA)> 

<!ELEMENT MatterNumber (#PCDATA)> 
50 <IELEMENT Client (#PCDATA)> 

<!ELEMENT Other (Field, ReldValue)> 
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<!ELEMENT Field (#PCDATA)> 
<!ELEMENT FieldValue (#PCDATA)> 
<!ELEMENT PlannedEnhancements (EnhancGment*)> 
<!ELEMENT Enhancement (dc:Contributor, dc:Date. What)> 
5 <!ELEMENT RevisionHistory (Revision*)> 

<!ELEMENT Revision (dciContributor, dc:Date. What)> 
<!ELEMENT dc:Contributor (Name, Organisation, md.ContactDetaiis)> 
<!ELEIV1ENT dc:Date (#PCDATA)> 
<!ELEI\4ENT What (#PCDATA)> 
10 <IATTLISTWhat 

ChangeType (l\/lajorRewori< | MinorChanges | BrandNew | ExtraContent | Update) 
"BrandNew" 
> 

<!ELEI\4ENT PartiesSetup (Party*)> 
15 <!ELEI\4ENT Party (DIsplayName, Role, PartyDetails)> 
<!ATTLIST Party 
%SmartsldRequired; 
Assessable (true | false) "true" 

> 

20 <!ELEiy/IENT DIsplayName (#PCDATA)>-- 

<IELEMENT Role %MappablePCDATA;> 

<!ELEMENT PartyDetails (PartyDetall+)> 

<!ELEMENT PartyDetail (Value+)> 

<!ATTLIST PartyDetail 
25 Name NMTOKEN #REQUIRED 

%SmartsldRequlred; 

> 

<IELEMENT Value %SmartsPCDATA;> 
<IATTLIST Value 

30 Gender (Male | Female | Neuter | Unspecified) "Unspecified" 

Number (Singular | Plural | Unspecified) "Unspecified" 

> 

<!ELEMENT PartyReference EMPTY> 
<!ATTLIST PartyReference 
35 %SmartlDREF; 

Type IDREF #REQUIRED 

Style NMTOKEN #IMPLIED 

> 

<!ELEMENT LogicSetup (Condition | MultipleCholceQuestion | 
40 %SmartsPhraseLeve!Declaratlons;)*> 

<1ENTITY % booleanSubstitute " Test | UseCondition | And | Or | Not "> 
<!ELEMENT Condition (True | False | %booleanSubstltute;)> 
<IATTLIST Condition 
%SmartsldRequired; 

45 > 

<!ELEMENT True EMPTY> 

<iELEMENT False EMPTY> 

<1ELEMENT Test EMPTY> 

<!ATTLISTTest 
50 uri CDATA #IMPLIED 

%SmartslDREF: 
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Value CDATA#REQUIRED 

> 

<!ELEMENT And ((%booleanSubstitute;). (%booleanSubstitute;))> 
<! ELEMENT Or ((%booleanSubstitute;), (%booleanSubstitute;))> 
5 <!ELEMENT Not (%booleanSubstitute;)> 
<!ELEMENT UseCondition EMPTY> 
<!ATTLIST UseCondition 

uri CDATA#IIVIPLIED 

%SmartslDREF; 

10 > 

<! ELEMENT Question %MappablePCDATA;> 
<!ELEMENT Topic %MappablePCDATA;> 

<!ELEMENT MultipleCfioiceQuestion (QuestionType, Question, Topic, Notes?, 
15 SelectionRules, Responses)> 

<!ATTLIST MuItipieChoiceQuestion 
%SmartsldRequired; 

> 

<!ELEMENT QuestionType EMPTY> 
20 <!ATTLIST QuestionType 

KeyQuestion (taie | false) "true" 

> 

<!ELEMENT Responses (Response, Response+)> 
<!ELEMENT SelectionRules EMPTY> 
25 <!ATTLIST SelectionRules 

Device (Checl<box | DropdownList) "Checkbox" 
AnswerUsing (Default | Bias) "Bias" 
. Cardinality (Single I Multiple) "Single" 

. > 

30 <!ELEMENT Response (SeiectlonCriteria, Prompt, SetValueTo, Notes?)> 
<!ELEMENT SeiectlonCriteria (Party/tesessment)*> 
<!ATTLIST SeiectlonCriteria 

Default (Checked | Unchecked) "Unchecked" 

> 

35 <!ELEMENT PartyAssessment EMPTY> 
<!ATTLIST PartyAssessment 
%SmartslDREF; 

Assessment (Worst | Bad | Neutral | Good | Best) "Neutral" 

> 

40 <!ELEMENT Prompt %MappabIePCDATA;> 
<1ELEMENT SetValueTo (#PCDATA)> 



<!ELEMENT UserTextQuestion (Question, Topic, DefauKText?, Notes?)> 
45 <!ATTLIST UserTextQuestion 
%SmartsldRequired; 

Columns (1 | 2 | 3 | 4 | 5 | 10 1 15 | 20 | 25 | 30 | 40 | 50 | 60 | 70) "20" 

Rows (1 I 2 1 3 I 4 I 5 I 6 I 7 I 8 I 9 I 10 I 12 I 14 I 15 1 16 I 18 I 20 I 25 I 30) "1" 

Type (Text | Duration | Time | Date | Decimal | Integer) "Text" 

50 > 

<IELEMENT DefaultText (#PCDATA)> 
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<!ELEMENT InsertUserText EMPTY> 
<!ATTLIST InsertUserText 
%SmartlDREF: 

> 

<!ELEMENT ReusablePhrase (#PCDATA %SmartsPhraseLevellnsertions; )*> 
<!ATTLIST ReusablePhrase 
%SmartsldRequired; 

> 

<!ELEMENT InsertReusablePhrase EMPTY> 
<!ATTLIST InsertReusablePhrase 
%SmartlDREF; 

> 

<! ELEMENT ConditlonalPhrase (#PCDATA | PartyReference 
%SfnartsPhraseLevelInserUons; )*> 
<!ATTLIST ConditlonalPhrase 
%SmartsConditlons; 

> 

<IELEMENT Notes (Note)*> 
<!ELEMENT Note (NoteTltle, NoteBody)> 
<IATTLIST Note 

UserLevel (Specialist | Non-Specialist) "Non-Specialist" 

ShowExtemalUsers (true | false) "false" 

Completioninstruction (true | false) "false" 

> 

<IELEMENT NoteTitle (#PCDATA)> 
<!ELEMENT NoteBody (p)+> 

<!ELEMENT p (#PCDATA | %HtmlParagraphMarkup;)*> 

<!ELEMENT b (#PCDATA)> 

<!ELEMENT i (#PCDATA)> 

<!ELEMENT a (#PCDATA)> 

<!ATTLISTa 

href CDATA #REQUIRED 
target CDATA #FIXED "_blank"> 



Another advantage of separating logic source files 210 firom document source files 208 is 
that the logic source files 210 can also be re-used in conjunction with other XML 
documents, simplifying maintenance. For similar reasons, it is convenient to store logic 
information in separate files rather than, for example, one monolithic logic file. This 
allows related infoimation to be grouped together, and only the logic conq>onents that are 
required need to be re-used with a given source document. 

It will be apparent that this information could alternatively be stored in a database rather 
than separate XML files. Separate XML files are preferred because they can be easily 



wo 03/075191 



PCT/AU03/00253 



-29- 

arranged in a hierarchical file system. However, if a logic source which is in use is moved, 
then a hase XML document that refers to the logic source will include an incorrect URI, 
and will need to be updated. In an altemative embodiment, the repository 208 in which the 
source documents are stored detects the fact tiiat the logic source has been moved, and 
updates tiie references to that logic source automatically, or alternatively, advises a URI 
resolver (the purpose of which is to translate old locations to actual locations) of the new 
location. This approach can be implemented with file systems that allow extra code to be 
executed automatically when a file is moved, renamed or deleted. Many WebDAV server 
implementations are provided with source code, which would enable a document assembly 
system which used a webDAV server as its repository 208 to implement this. 

In yet a fiirther alternative embodiment, the document assembly system includes a single 
resource that authoritatively associates the name of a logic source with its location, so that 
in a reference to a logic source, a source document includes the name of the resource 
known to the system (together with the party mapping being used, as to which see finlher 
below). In this embodiment, only that single resource needs to be updated when a logic 
source is moved or renamed. 

A logic source can refer to one or more other logic som-ces. For example. Figure 8 shows a 
first logic source 802 that builds additional logic on top of that available in second 804 and 
third 806 logic sources. The third logic source 806, in turn, builds additional logic on top 
of a fourth logic source 808. However, the base XML document 812 only refers to the first 
802 and a fifth 818 logic sources. Thus a convention is needed as to the scope or 
"visibility" of logic. The convention used in the preferred embodiment is that the only 
logic sources visible in a particular document (either an XML source document or a logic 
source) are those declared in that document's <LogicSources> element. Consequently, if 
the base XML document 812 needed to use a condition defined in the fliird lo^c source 
806, it would need to import that logic source in its <LogicSources> element. This would 
be achieved by an administrator editing the source document 812 using the editor 1 12. 

Figure 8 also shows the base XML document 812 reusing an XML firagment 814 by 
reference. A "SmartModule" processing instruction is used for this puxpose because use of 



wo 03/075191 



PCT/AU03/00253 



-30- 

the source document of the standard XML inclusion mechanism Xinclude, documented at 
http://www.w3.orgnrR/xinclude/, would invalidate the source document unless the 
grammar for the soiirce docimient specifically allowed its use. In Figure 8, the XML 
firagment 814 imports a sixth logic source 816, The latter is not visible to the base XML 
5 document 812. 

Assembled documents often refer to one ormore parties. For example, a legal document 
. might refer to the parties involved in an agreement of some kind. In such cases there are 
often only two parties involved, but in some circumstances there may be many parties. A 
10 logic source specifies the parties known to it, in its PartiesSetup element. 

A party mapping is a child on a logic source import that allows parties used in a logic 
source to be mapped to parties xised in a document importing the logic source. This makes 
it possible for a logic source which, for example, refers to a Plumber and a Homeowner, to 
15 be used in a document between a Banker and a Customer. 

K party mapping chain is a chain of party mappings between a base XML document and a 
logic source. It will be evident that a party mapping chain can swap two parties around 
e.g^ if the LogicSource import statement in the base XML docxmient 812 for the first logic 
20 source 802 said, in effect, "Employer becomes Employee and Employee becomes 
Employer*'. Thus two references to the same physical logic source are regarded as logically 
the same if and only if dieir respective party mapping chains result in the same party 
mapping. 

25 It is not an error to import the same logic source twice in a single LogicSources statement 
(allocating each occurrence a distinct ID). This allows one physical question or condition 
to be used for two logical questions by defining different party mappings in each 
LogicSource import statement. 

30 In addition to those described above, the example source document and logic source above 
include seven other types of processing instmction: 

(i) Condition 

(ii) InsertReusablePhrase 
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(iii) InsertUserText 

(iv) PartyReference 

(v) ArrayRowlterator 

(vi) SmartModule 
5 (vii) Notes 

(viii) Metalnformation 

For half of these, there is a correspondence between a processing instruction in a source 
XML document and an element in a referenced logic source. That is, when software 
10 manipulates or interprets the processing instruction, it does so in conjunction with the 
corresponding element in the logic source. This correspondence is as follows: 



Processing Instruction 


LogicSource 


Condition 


Condition 


InsertReusablePhrase 


ReusablePhrase 


InsertUserText 


UserTextOuestion 


PartyReference 


Party 



ArrayRowlterator, SmartModule, Notes and Metalnformation are exceptions to this - an 
15 ArrayRowlterator is independent, as is Notes and Metalnformation, while a SmartModule 
has a correspondence with a fragment of XML stored at some other URI. 

A Condition processing instruction specifies by convention that its parent element should 
only be included in the instance document if the associated condition evaluates to true. For 
20 example, the following condition is taken from the example source document given above. 
<p> 

<?SpeedLegal <Condltion IDREF="AmountOfLeave. negotiate" 
LogicSource="LoglcSource_17>7>The amount of leave is negotiated with the 
employee.</p> 

25 

This means that the <p> element will only be mcluded in an instance document generated 
from this source docmnent if the Condition AmountOfLeave.negotlate in the logic source 
named "LogicSource_1" is true. It will be ^parent that alternative embodiments could be 
developed to implement the condition is other ways. For example, the Condition could by 
30 convention apply to the following sibling, or Condition open and Condition close 
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processing instructions could be used to surround fhe XML to which the condition is to 
apply. However, neither of these approaches is preferred. In the first case, there may be 
no following sibling. Li the second case, if the open and close processing instructions are 
not properly nested so that they precede and follow, respectively, a matching pair of tags, 
5 then the restilting instance document would not be well-formed. Similarly, the syntax of 
the Condition PI could have been written in various ways, some of which include data that 
looks like XML, and others that do not, including: 

(i) <?SpeedLegal <Conditlon IDREF="AmountOfLeave.negotlate" 
10 LogicSource="LogicSource_17>?> 

(ii) <?SpeedLegal <Logic type="condition" IDREF="AmountOfLeave.negotiate" 
LogicSource="LogicSource_1 "/>?> 

(iii) <?Condition <data IDREF="AmountOfLeave.negotlate" 
Log!cSource="LogIcSource_1 7>?> 

15 (iv) <?Conditlon IDREF="AmountOfLeave.negotiate" 
LogicSource="LogicSource_1 "?> 

(v) <?Condition IDREF="AmountOfLeave.negotiate"; 
LogicSource="LogicSource_1 "?> 



20 



(vi) <?Condition LogicSource_1#AmountOfLeave.negotiate"?> 
However, the first of these is the form used in the preferred embodiment 



The IDREF attribute of a condition PI specifies the ID of the condition to be tested; the 
LogicSource attribute is an IDREF to the logic source in which the condition is defined. 
25 For example, the logic source file with an IDREF of "LogicSource_1" and listed above 
contains the definition of the AmountOfLeave.negotiate condition, as follows: 

<Condition I D="AmountOfLeave.negotiate"> 

<Test lDREF="AmountOfl.eave" Value="negotiate"/> 
30 </Condition> 

This means that the condition will evaluate to true if the response given for the question 
named (/.e,, with an IDREF equal to) "AmountOfLeave" has the value "negotiate". The 
question "AmountOfLeave" is a multiple choice question defined in the logic source, as 
35 follows: 



<MultipleChoiceQuestion ID="AmountOa.eave'^ 
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<QuestionType KeyQuestion="false7> 

<Question>How much leave is <PartyReference IDREF="Ennployee" 

Style="Flrstname" Type="PartyDetalL07> entitled to?</Question> 
<TopioSetup</Topio 
5 <SelectionRules AnswerUsing="Bias" Cardinality="Single" 

Device="Checkbox7> 
<Responses> 
<Response> 

<SelectionCr1teria Default="Unchecl(ed"> 
10 <PartyAssessment Assessment="Best" IDREF="Employer/> 

</SelectionCriteria> 

<Prompt>Award entltlements</Prompt> 
<SetVaIueTo>award</SetValueTo> 
</Response> 
15 <Response> 

<SelectionCriteria Default="Unchecked"> 

<PartyAssessment Assessment="Worst" IDREF="Employer"/> 
</SelectionCrlteria> 

<Prompt>By negotiation witli <PartyReference IDREF="Employer 
20 Style="Name" Type="PartyDetail_2"/> 

</Prompt> 

<SetValueTo>negotlate</SetValueTo> 
</Response> 
</Responses> 
25 </MultipleChoiceQuestion> 



In this example, the MultipleChoiceQuestion elemmt's QuestlonType child has value 
•false" for attribute KeyQuestion. This means that the processing engine 202 is free to 
30 attempt to answer this question itself (/.e., without interacting with any external agent) 
using its scoring procedure if the user or software invoking the Processing Engine 202 
indicated they only wished to be asked Key Questions. 

If the SelectionRuIes element has value "Bias" for the AnswerUsing attribute, as is the case 
35 here, then the processing engine 202 scoresjpach respoiise based on the values contained in 
its SelectionCriteria child and which party the user or software invoking the Processing 
Engine 202 indicated they wish to favour. Alternatively, if the SelectionRuIes element has 
value "Default" for the AnswerUsing attribute, ttien the processing engine 202 selects the 
response for which the SelectionCriteria element's "Defauir attribute has value "Checked". 
40 For example. Figure 11 shows a screenshot of a web browser window displaying this 
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question in HTML generated by the Java Controller servlet 218 of the document assembly 
system. 

In the above example, the MultipleCholceQuestion is defined in the logic source that also 
5 defines the condition. However, a definition in a different logic source can be used, 
assuming that different logic source was declared in the LogicSources element (of the 
logic source which defines the condition), by including its IDREF name (/.e., the name 
assigned to it in the logic sources element) in the Test element, for example: 

10 <Test IDREF=" AmountOfLeave " Value=" negotiate " LogicSource="LogicSource804" /> 

A condition can be defined in terms of other conditions, usiag boolean logic operators. In 
the example, the Condition PaidLeave is defined as follows: 

15 <Condition ID="PaidLeave"> 

<Or> 

<UseCondition IDREF="EmpIoymentJype.Fuimme7> 
<UseCondmon IDREF="Employment_typePartTime"/> 
</Or> 

20 </Condition> 

This condition will be true if either the condition Employment_type.FullTime is true or the 
condition Employment_type.ParlTime is trae. 

25 It will be evident diat condition Pis as described above can only be attached to elements. 
The question arises - what if it is desired to attach a condition to some text which is not 
tagged (or it is not desired to tag, or, because of the grammar, cannot be tagged) with an 
element to which a condition can be attached. There are several possible solutions to fliis. 
One possibility is to define opening and closing Condition Pis that surround the text in 

30 question. However, this approach has drawbacks already adverted to above. In the 
preferred embodiment, the text is defined in'a logic source, and an "InsertReusablePhrase" 
processing instruction is used to refer to it in the source document. 

There is an InsertReusablePhrase in the example XML document above: 

35 
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<p>..may request <?SpeedLegaI <lnsertReusablePhrase 

IDREF="PaidOrUnpalclLeave" LogicSource="LogicSource_17>7> by filling in a request 
form at least one month prior to the earliest date required.</p> 

5 The corresponding ReusablePhrase with ID "PaidOrUnpaidLeave" is defined in the logic 
source as follows: 

<ReusablePhrase ID="PaidOrUnpaidLeave">unpald <ConditionalPhrase 
Condition="PaidLeave">or pald</ConditionalPhrase> leave</ReusablePhrase> 

10 

Thus a ReusablePhrase can contain not only text, but other things which are evaluated. 
One of these is a "ConditionalPhrase", This is an element which is defined in the logic 
soxirce schema or DTD, mainly for the purpose of allowing a condition to be attached. In 
this way a ReusablePhrase can be used to conditionally insert text into the XML 
15 document in the absence of an element to which a condition can otherwise be attached. In 
altemative embodiments, a condition could be attached directly to the ReusablePhrase 
element as an attribute, or a new processing instruction defined which specifies both a 
condition and the text to be inserted if the condition is true. 

20 Information entered by a user in response to a question can also be inserted into an 
instance document. For example, suppose that the source document listed above included 
the following processing instruction: 

<?SpeedLegal 

25 <lnsertUserText IDREF="LetterSubject" LogicSource="LogicSource_1"/> 

?> 

The rendering engine 204 processes this instruction by inserting, in the instance docxmient, 
the value the response provided by the user) of the user text question with ID 
30 "LetterSubject" that is defined m the logic source "LogicSource_1 

That user text question is defined in the logic source as follows: 



<UserTextQuestlon Columns="20" ID="LetterSubject" Rows="1"Type=Text"> 
35 <Question>What is the subject of this letter?</Question> 
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<Topic>Subject of Letter<yTopic> 
<AJserTextQuestion> 

The type attribute restricts the allowed type of input to the specified format, which is one 
5 of text, duration, time, date, decimal, or integer. In this example, the user can enter free 
text. 

In an alternative embodiment, xisers are given greater flexibility to define and use their own 
variable types. This gives the user the ability to validate a broader and more complex range 
10 of data types than is possible with a closed set. For example, a UserTextQuestion can be 
assigned a defined data type as follows: 

<UserTextQuestion AskEachRepeat="f alse" Coluinns="20" ID="HourlyRate" 
Rows="l" Type=:"DollarValue"> 
15 <Question>What is <PartyRef erence IDREF= "Recruit »• Style="Shortname" 

Type="PartyDetail_10"/></PartyRef erence>&apos; s hourly rate?</Question> 

<Topic>Salary, benefits and payment </ Topi c> 

<DefaultText>S40</DefaultText> 
</UserTextQuestion> 

20 

More generally, a Variable has an assigned data type, as follows: 

<Variable type="DollarValue" name="ContractorHourlyRate" 
query= " Cont rac torRat e " / > 

25 

The data types are defined either in the logic file: 

<DataTypes xmlns="http://www.w3 .org/2001/XMIiSchema"> 
<simpleType name="DollarValue"> 
30 <cUinotation> 

<docuinentation> 

An amount of money in dollars, as in "$100.50" 
< / document at ion > 
</aimotation> 
35 <restriction base=:" string" > 

<pattern value="S [0-9] + (\ . [0-9] {2})?"/> 
</restriction> 
< s impleType> 
</DataTypes> 

40 

or in a separate location for global access: 

<?xml version="1.0" encoding="utf -8V»- ?> 
<schema xralns="http : //www. w3 .org/2(J0l/XMLSchema"> 
45 <1-- Some example types --> 
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< sintpleType name= "NonEraptyString " > 
<annotation> 

<documentation>A string containing at least one 
character</documentation> 
5 </annotation> 

<restriction base=" string" > 

<minliength valuer" l"></tninLength> 
</restriction> 
< / s impleType> 

10 

<sirapleType name="SiinpleDate"> 
<annotation> 

<documentation>A date in the format "15 Jan 
2002£cguot ; </ document at ion> 
15 <appinfo> 

<SIi : DateFormat 

xmlns : SL= "http : //vn^w . speedlegal . com/namespaces/sraarts ">dd MMM 
yyyy < / SL : DateFormat > 
</appinfo> 
20 </annotation> 

<restriction base=" string" ></restriction> 
</sirapleType> 

oimpleType name="DollarValue" > 
25 <annotation> 

<documentation>An amount of money in dollars, as in 
" $100 . 50&c[uot; < /document ation> 
< / anno t a t ion> 

<restriction base=" string" > 
30 <pattem value="$ [0-9] + (\ . [0-9] {2 } ) ? "></pattem> 

</restriction> 
< / s imp leType > 

This data typing relies on XML -'Schema simple types, as described at 
35 http ; //www. w3 ■ org/TR/xmlscliema-2/ . 



The documentation element of the simpleType is used to provide explanatory text to tiie 
user during the authoring and interview stages. Document authors are provided with a list 
of available data types. Once a Variable is assigned a type, flie Query that populates it 
40 returns content of the required type. If the Query results in an Interview Item, the user 
inputs data of the required type. If the input data is not of the required type, then the user is 
provided with feedback using the docimientation element, and is informed as to what data- 
type is expected. The Interview Item is then re-answered. 



45 Diuing the authoring process, the documentation element can be used to indicate to an 
author what each data type is intended to represent. 
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The appinfo element of a simpleType can be used to perfonn customised checking m 
addition to schema type checking, hi the example above, SimpleDate is a custom date 
fomiat. A value of this type is vahdated in two phases. It is first checked to be a string 
5 according to the normal schema validation rules, identified as such via the restriction 
element Secondly, it is checked using a separate more specific validation fimction 
identified by the appinfo elraaent. 

Interview Item responses are type-checked using schema data type validation functions. 
iO These are available in libraries such as Sun's XML Data Types Library (xsdlib), available 
at http://wwws>simxom/soflAvare/xml/developers/xsdlib2/ . These fimctions can also be 
used within the authoring environment to check the type of default values. 

In the preferred embodiment, MultipleChoiceQuestion and UserTextQuestion are distinct 
15 elements, even thougfh their content shares some common characteristics a question). 
In an alternative embodiment, the common characteristics are abstracted out in the DTD, 
(or, alternatively, schema) as follows: 

<!ELEMENT Intervlewltem (question, Topic, Notes?, ( MultipleChoiceQuestion | 
20 UserTextQuestion )) > 

hideed, the Interviewltems package 408 of the Processing Engine 202 of the preferred 
embodiment uses an abstract class called Interviewltem that captures the conmionalities 
between MultipleChoiceQuestion, UserTextQuestion, etc, with subclasses that represent 
25 the specifics of each case. 

Moreover, although UserTextQuestion is implemented with a type attribute in the 
preferred embodiment, the different types could alternatively be implemented as elements 
in their own right, in which case the interviewltem element declaration might look like: 

30 

<!ELEMENT Interviewltem (question, Topic, Notes?, ( MultipleChoiceQuestion | 
UserTextQuestion { Duration | Time | Date | Decimal | Integer )) > 



wo 03/075191 



PCT/AU03/00253 



-39- 



A party reference processing instruction is used by the processing engine 202 to genraate 
text referring to a party. For exanq)le, the following: 

<?SpeedLegal 

5 <PartyReference IDREF="Employee" LogicSource="LoglcSource_r 

Style="Pronoun" Type="PartyDetaiL1 "/> 

?> 

in a source XML document results in the insertion, into the instance document, of the value 
10 of the PartyDetall whose ID corresponds to the Type attribute for that party. In tiiis 
example, the relevant party is "Employee". 

<Party Assessabte="tnje" lD="Employee"> 
<DisplayName>Employee</DisplayName> 
15 <Role>The person to be offered a position under this letter.</Roie> 

<PartyDetails> 

<Partypetail ID=s"PartyDetall_0" Name="Firstname"> 
<Value Gendep="Unspecified" Number="Unspecified"> 
<lnsertUserText iDREF="EmpIoyeeFirstname7> 
20 </Value> 
</PartyDetail> 

<PartyDetaii ID="PartyDetaii_1" Name="Pronoun"> 

rvalue Gender="Unspecified" Number="Singular">He<A/alue> 
<Value Gender="Female" Number="Singular">She</Value> 
25 <Value Gender="Unspecifled" Number="Plurai">They</Value> 

</PartyDeteiil> 
</PartyDetails> 
</Party> 

30 It can be seen from this example that the PartyDetail can contain values for different 
Gender and Number. Assuming the Gender and Number of the party has been ascertained 
(in this embodiment a question to do so is automatically generated by the processing 
engine 202 when required), the corresponding value can be evaluated by the Processing 
Engine 202, and inserted by the Rendering Engine 204, as described below. 

35 
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It will be evident fliat other attributes could be included on the PartyDetail Value children, 
for example, "Formar, which would be useful with some languages other than English. 

The example document contains aprocessmg instruction specifying an ArrayRowlterator: 

5 

<tr> 

<?SpeedLegal <AnrayRowlterator repeat="NumberOfLeaveTypes7>?> 
<td><?SpeedLegal <ArrayReference IDREF="LeaveType"/>?> 

10 If an XML element has an ArrayRowlterator child, then that element (<tr> in this example) 
will be copied into the instance document one or more times. When the source document 
is processed by the Processing Engine 202, the processing engine 202 determines how 
many times that element is to be included in the instance document. To determine this, it 
uses a "repeat" attribute. If liie value of the repeat attribute is a positive integer, then the 

15 element is included that many times. Otherwise, the value of the repeat attribute is the 
name of an interview item that can only take an integer response (preferably, any linait on 
the range is specified in that interview item). 

For each time it is copied in, a distinct value is required for each fiiterview Item referred to 
20 in an ArrayReference processing instruction, For example, if the value of the repeat 
attribute was 2, then the first time the <tr> element appeared the first row), the 
UserTextQuestion "LeaveType" might have value "Annual Leave"; and the second time 
(e.g.y the second row), "Maternity Leave". 

25 The Interviewltems package 408 contains a class that represents an ArrayRowlterator. The 
ArrayRowlterator class contains a collections object which contains UserTextQuestions 
and MultipleChoiceQuestions for each row. When the ArrayRowlterator is passed to the 
invoking process 412 to be answered, the UserTextQuestions and 
MultipleChoiceQuestions contained within it are asked as necessary. 
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In the preferred embodiment, there is no corresponding element in any logic source for an 
ArrayRowIterator processing instruction. In other words, nothing is needed in any of the 
logic sources (beyond ordinary Interview Items e.g.^ MultipleChoiceQuestions and 
UserTextQuestions) which are referenced by the ArrayReference processing instructions). 

5 

It is often desirable to use an Interview Item, within an element that has an 
ArrayRowIterator child, that takes the same value each time the element is repeated (in 
other words, such an Interview Item does not get asked for each row). 

10 Consequently, the preferred embodiment uses the same value each time imless an 
ArrayReference processing instruction is provided. The ArrayReference processing 
instraction specifies that the corresponding item is to be treated as an array of questions 
(e.g.y asked again for each row), rather than assuming this for any interview item that 
occurs within an element wifli an AnrayRowlterator child. If that assumption were valid, 

1 5 then there would not be any need for an ArrayReference processing instruction. 

An altemative embodiment which did not make this assumption but also did not use an 
ArrayReference processing instruction might include an attribute on each Interview Item 
which indicated whether in an array the interview item was asked just once, or once each 
20 array iteration. For example, that attribute might be named ArrayRowIteratorBehavior 
with allowed values "variant" or "invariant", and appear on the Question child of a 
UserTextQuestion or MultipleChoiceQuestion. 

A SmartModule processing instruction is used in a source document to indicate that a 

25 fragment of XML at a specified URI is to be retrieved when the source docxmient is run 

through the processing enguie 202. For exsmple, the following is taken firom the example 

source document: 

<?SpeedLega! 

<SmartModule url="/home/jml/termination.sm"> 
30 <PartyMapping> 

<PartyMap From="Contractor" To="Employee"> 

<PartyDetailMap From="Shortname" To="Flrstname"A> 
<PartyDetailMap From="FulIname" To="Firstname7> 
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</PartyMap> 
</PartyMapping> 
</SmartModule> 

?> 

5 

The PartyMapping is used to translate PartyReferences in the XML fragment referenced 
by the SmartModuIe PI to references to party details on parties that are known to the 
source XML docxunent. For example, consider a base or main XML document 812 that 
refers to parties PI, P2, and E, as shown in Figure 9. The XML document 812 references 

10 the first logic source 802 which contams references to parties PI and P2. The XML 
document 812 also references a second logic source 804 that contains references to parties 
A and B only. The base document 812 also references a third logic source 806 that 
contains references to parties C, D, and E only. However, the third logic source 806 itself 
refers to a fourth logic source 808, containing references to parties M and N. The third 

15 logic source 806 (which defines parties C, D and E) needs to use logic contained in the 
fourth logic soxurce 808. However, the only party names "known" to the fourth logic 
source 808 are M and N. To allow the logic referring to parties M and N in the fourth logic 
source 808 to be xxsed for parties C and D, the reference to the fourth logic source 808 in 
the third logic source 806 includes party mapping instructions to map any references to 

20 party M in logic imported fi:om the fourth logic source 808 to refer instead to party C. 
Similarly, party N is mapped to party D. By performing this party moping, the third logic 
source 806 is able to use the logic contained in the fourth logic source 808 in statements 
referring to parties known only to the third logic source 806. 



25 Referencing and party mapping can be nested. In order for flie main XML document 812 to 
make use of the logic contained in the second logic source 804 and the third logic source 
806, the main document 812 includes party mapping instructions to map parties A and B of 
the second logic source 804 to parties PI and P2, respectively. For the third logic source 
806, parties C and D are mapped to parties PI and P2, respectively; because there is no 

30 mapping for party E, it becomes "known" to the main XML document). However, because 
the third logic source 806 contains a reference to the fourth logic source 808, the logic 
imported firom the fourth logic source 808 effectively imdergoes two levels of party 
mapping, referred to as a party mapping chain. That is, references to parties M and N in 
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logic from the fourth logic source 808 that were already mapped to C and D as described 
above are now m^ped again, in this case to parties PI and P2, respectively, when 
imported into the main XML document 812. 

If a single logic soxirce is used more than once it is used in different logic sources, in 
which case, in the example in Figure 8, that logic source would be depicted more than 
once), then instances of a piece of logic contained within it that is used more than once are 
regarded as distinct if and only if the party mapping chains for the instances of the logic 
sources are distinct. 



As shown in Figure 10, party mapping can also be performed for XML source fragments 
imported into the main XML source document 812 via a SmartModule processing 
instruction. For example, a first XML fragment 1002 contains references to parties X and 
Y. In order to import ttiis fragment 1002 into the mam XML document 812, these parties 
15 are mapped to parties known to the main XML document 812, two of the parties PI, 
P2, and E. Similarly, a second fragment 1004 containing references to a party Z can be 
imported into the main XML document 812 by mapping the party Z to one of these three 
parties. 

20 A Notes processing instruction is used to present one or more notes to a user, via their 

browser display and/or in a printed document. For example: 

<?SpeedLegal 
<Notes> 

<Note Completionlnstruction="false" ShowExternalUsers="false" 
25 UserLevel="Non-Specialist"> 

<NoteTitIe>Paid and Unpaid Leave</NoteTitIe> 
<NoteBody><p>All employees can request <b>unpaid</b> 
leave</p><p>Only <b>Full-time</b> or <b>Part-time</b> 
employees who have accrued leave can request <b>paid</b> 
30 leave-</p></NoteBody> 
</Note> 
</Notes> 

?> 
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The Completionlnstructlon attribute indicates whether the note provides information as to 
how the document should be completed; the ShowExtemalUsers and UserLevel attributes 
allow the note to be shown or not shown, depending on whether the user matches the 
specified criteria. UserLevels can be defined arbitrarily. A user is defined to be external 
5 for the purposes of ShowExtemalUsers if, in a role-based access control system, the user is 
ia an external role {i.e., external to the organisation running the document assembly 
system). Notes can also be attached to a question or a response of a UserTextQuestion or a 
MultipleChoiceQuestion in a logic source. 

10 The Metalnformation processing instruction allows meta-information to be attached to an 
element in a source document. There is also a Metalnformation element defined in the 
grammar for a Logic Source. In this embodiment, that definition uses concepts provided by 
RDF and Dublin Core, as described at httD://www.w3.org/TR/R EC-rdf-svntax and 
httD://dublincore.org/schemas/xmlsA respectively. The format of the Metalnfonnation PI 

15 data is the same as the definition of the Metalnformation element in the Logic Source 
grammar. 

Most of the examples presented .above demonstrate the resolution of 
MutipleChoiceQuestions and UserTextQuestions by presenting a question to an end user 
20 and receiving a response to that question from the end user. In an alternative embodiment, 
where UserTextQuestions, ReusablePhrases, Conditions and ArrayRowIterators (Repeats) 
are viewed as specific instances of a general class of constructs named Variables, a 
LogicFile can be constructed such that Variables are able to be resolved firom other sources 
(Queries). 

25 Consider the following LogicFile elements: 
<LogicSetup> 

<DataTypes xmlns="http://www.w3 .org/200l/XMIiSchenia"> 
<siinpleType name="DollarValue"> 
<annotation> 
30 <documentation> 

An amount of money in dollars, as in "$100.50" 
</documentation> 
</axmotation> 

<restriction base«" string" > 
35 <pattem value=="S [0-9] + (V [0-9] {2}) ?"/> 

</restriction> 
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< s impl eType > 

<siinpleType name="SimpleDate"> 
<annotation> 

<documentation>A date in the format "15 Jan 
2002&quot ; </docuraentation> 
<appinf o> 

<SL : DateFormat 

xmlns:SIi="http://www.speedlegal.com/namespaces/smarts">dd MMM yyyy 
</SL : DateFormat > 
</appin£o> 
</annotation> 

<restriction base=" string" ></res trie tion> 
</ simpleType > 

</DataTypes> 

<Dat aSour ce s > 

<DataSource type="jdbc" name="databasel"> 

<Param name="driver" valuer " com. microsof t .mssql. Driver" /> 
<Param name="url" valuer" jdbc : //127 . 0 . 0 . l"/> 
<Param name="usemame" value= "Generic Usemame"/> 
<Param name= "password" value= "Generic Password"/> 
</DataSource> 
< /Dat aSource s > 

< Variables > 

<Variable type="SimpleDate" naTne="StartDate" query=" Gets tar tDate"/ 
<Condition name="MaternityLeave" query="IsFemale"/> 
<Repeat name= "Number Jobs " query= "Number JobOpenings " / > 
<Variable type="number" name=5"CalculatedNumber" c[uery=" js-1" /> 
<Variable type="DollarValue" name="ContractorHourlyRate" 
query= " Cont rac torRate " / > 
</Variables> 

<Queries> 

<Query name="GetStartDate"> 
<Answers> 

< Answer ref ="StartDate"/> 
< /Answers > 

<UserText Quest ion columns="40" rows="l"> 

<Question>Please enter <PartyRef erence party=" Employee" 
styles "Shortname" ref="N232"/>'s starting date</Question> 
<DefaultText>01 Jsoi 2003</Def aultText> 
< /Us er Tex t Que s t ion> 
< /Query > 

<Query name="IsFemale"> 
<Answers> 

<Answer ref ="MatemityIjeave"/> 
< /Answers > 
<Condition> 

<Test var="EmployeeGender" equals=" female"/ > 
</Condition> 
</Query> 
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<Query name="ContractorRate"> 
<Answers> 

<Ans wer ref = " ContractorHourlyRate " / > 
5 < /Answers > 

<ConstcUit value="$25.00"/> 
</ Query > 

<Query name=" j s-l"> 
<Answers> 

<Answer ref ="CalculatedNumber "/> 
</Answers> 

<Script language=" javascript "> 
<Parameters > 

< Parameter ref =** reference -to -some -parameter" name="foo"/> 
<Parameter ref ="ref erence-to-another-param" name="bar"/> 
</Parameters> 
<Punction> 

(foo + bar) /ID * Math.cos (foo+1) 
</Function> 
</Script> 
< /Query > 

<Query source="databasel" name= "Number JobOpenings " > 
<Ans wer s > 

<Answer ref = "Number Jobs " / > 
< /Answers > 
<Dat abas eQuery > 

<Parameter name="argl" ref = "Department "/> 
<Result columns" 1" ref «= "Number Jobs"/ > 
<Query> 

select count (positions) from positions where 
department=s${argl} and f illed=f alse; 
</ Query > 
</DatabaseQuery> 
</Query> 
</Queries> 
</LogicSetup> 

40 In the fragment above, five Variables or differing types are defined and their values are 
obtained from various sources, as listed in the Table below. 



Variable Name 


Type 


Source 


StartDate 


SimpleDate 


Uses UserTextQuestion Intorview Item to 

obtain value 


MatemityLeave 


Condition (boolean) 


Test answer to a MultipleChoiceQuestion 
Interview Item to determine gender 


NumberJobs 


Repeat 


Uses a database query to determine the 



10 



15 



20 



25 



30 



35 
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(noiiNegativelnteger) 


number of unfilled positions in a given 
department 


CalculatedNumber 


number 


Calciilates a result based on a function and 
other Variables defined in the Logic File 


ContractorHourlyRate 


DoUarValue 


Constant value 



In this embodiment, a UserTextQuestion is an Interview Item Query that is used to 
populate a Variable of any data type. A Condition is a Variable of fixed type (boolean) that 
obtains a true or false value firom a Query. Repeats or ArrayRowIterators are Variables of 

5 fixed type (integer zero or greater - nonNegativelnteger) where the value is obtained fi-om 
a Query, A Variable is a general element of any type that obtains its value fi-om a defined 
Query. ReusablePhrases are collections of arbitrary Conditional text, PartyReference and 
InsertUserText elements defined within the logic file that allow users to convenientiy 
define reusable objects. A Query is an element that populates one or more Variables 

10 (Answers) by taking in zero or more Parameters (other Variables). Queries encompass: 

(i) Ihterviewltems where the Query is resolved via the interview e.g. 
MultipleChoiceQuestions, UserTextQuestions; 

(ii) evaluations where the Query is resolved by the result of some function 
expressed using set syntactic rules. The evaluation syntax allows different 

15 languages to be used to evaluate the expression. In the example above JavaScript is 

used. Parameters may be passed into the function and these can be given local 
aliases such that language specific variable name constraints are not violated; and 

(iii) other queries such as database lookups, extraction of information firom other 
files, retrieval fit)m web services, directory services etc. In the example above a 

20 database lookup is demonstrated where the database setup parameters are defined 

within the <DataSources> element. Alternatively these parameters could be defined 
in a separate location for global access. 

A Query contains refermces to the Variables or Answers that it populates. A single Query 
25 can potentially resolve many Variables. This is especially useful for database sources 
where one lookup can return many fields of data. A Variable may also reference its 



wo 03/075191 



PCT/AU03/00253 



-48- 



resolving Query for convenience. A Query implementation may contain a default value 
that is used when the Query fails. Queries may fail for a variety of reasons including 
inaccessibility, recursive or looping queries, incorrect syntax, and incorrect setup. 



S Failure mechanisms can be defined such as: 

(i) document is not generated and feedback is presented to the user; 

(ii) document is generated with default text if it exists or markers such as ## if it 
does not; and 

(iii) the user is prompted to provide the information that the Query could not 
10 resolve. 



It should be noted that the LogicFile structure depicted above decouples the declaration of 
the Variable from information about where and how it is resolved. 



1 5 Variables can be referenced within an XML document as follows: 

<?xml version="1.0" encoding="UTF-8'7> 
<!DOCTYPE Letter PUBLIC "-//SpeedLegal/ZLetter 1vO//EN" 
'file:///home/speedlegal/dtd/xhtml-letter/dtd/xhtml-letter-v2.dtd"> 
<LettiBr> 
20 <?SpeedLegal 

<LogicSources> 

<LogicSource ID="LogicSource_1" uri=7files/logIc/LS1WD.Igc'' 
version=7history/SmartRepository/9/1.27> 

<LogicSource ID="LogicSource_2" uri="/files/logic/LS2WD.Igc 
25 version=7history/SmartRepository/1 9/1 .6"> 
<PartyMapping> 

<PartyMap From="Contractor" To="Employee"> 

<PartyDetailMap From="Shortname" To="Firstname7> 
<PartyDetailMap From="Fullname" To="Firstname7> 
30 </PartyMap> 
</PartyMapping> 
</LogicSource> 
</LogicSources> 

?> 

35 <?SpeedLegal 

<Meta lnformation> 

<rdf:RDF xmlns:dc="http://purl.org/dc/elements/1 ,1/" 
xmlns:rdf="http://\AftAAA/,w3.org/TRMD-rdf-syr)tax-ns#^^ 
<rdf:Description> 
40 <Metadata> 
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<dc:Type Genesis="Onglnal" Status="Unapproved" 

Use="Precedent7> 

<dc:Title>Letter template</dc:Title> 
<dc:Description>Template business letter</dc:Description> 
5 <dc:Subject><Keyword>Letler</Keyword></dc:Subject> 

<dc:Creator> 

<Name>SpeedLegal</Name> 
<Organisation>SpeedLegal</OrganisatIon> 
<md . ContactDetaiIs> 

10 <md.Address>Level 4, 85 Queen Street, Melbourne, 

Victoria</md.Address> 

<mdPhone>+61 3 9670 0141</md.Phone> 
<md.Email>info@speedlegaLconn</md.Ennail> 
<md.Fax>+61 3 9670 0142</md.FaX> 
1 5 </md.ContactDetails> 

</dc:Creator> 

<RevisionHistory> 

<Rev!sion><dc:Contributor><Nanrie>SpeedLegal</Name><Organisation>SpeedLeg 
20 al</Organisation><md.ContactDetails><md.Address>Level 4, 85 Queen Street, 
Melbourne, Victoria</md.Address><mdPhone>+61 3 9670 

0141 </mdPhone><nnd.Email>info@speedlegaI.com</rnd.Email><nrid.Fax>+61 3 9670 
0142</md.Fax></nnd.ContactDetalls></dc:Contributor><dc:Date>6/2/2002 
1 3:49</dc:Date><What ChangeType="BrandNew"'>Letter creation</What></Revision> 
25 </RevisionHistory> 

</Metadata> 
</rdf:Description> 
</rdf:RDF> 
</Meta I nf onmation> 

30 ?> 

<LetterHead> 
</Date> 
<Salutation/> 
</LetterHead> 
35 <LetterBody> 
<p> 

<?SpeedLegal <PartyReference IDREF="Employee" 
LogicSource="LogicSource_1" Style="Firstname" Type="PartyDetaiL07> ?> shall 
commence work on <?SpeedLegal <lnsertUserText IDREF="StartDate" 
40 LogicSource="LogicSource_1 " /> ?>. 
<p> 

<?SpeedLegal 

<Condition IDREF="PaidLeaye" LogicSource="LogicSource_17> 

?> 

45 <?Speed Legal 

<PartyReference IDREF="Employee" LoglcSource="LogicSource_r' 
Style="Pronoun" Type="PartyDetalM7> 

?> shall be eligible for paid leave.</p> 
<p> 

50 <?SpeedLegal 
<Notes> 
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<Note Completionlnstruction="false" ShowExternalUsers="false" 
UserLevel="Non-Specialist"> 

<NoteTitle>Paid and Unpaid Leave</NoteTitle> 
<NoteBody><p>AII employees can request <b>unpaid</b> 
5 leave</p><p>Only <b>Full-tlme</b> or <b>Part-time</b> employees who have 
accrued leave can request <b>paid</b> leave.</p></NoteBody> 
</Note> 
</Notes> 

?> 

10 <?Speed Legal 

<PartyReference IDREF="Employee" LogicSource="LogicSource_1" 
Style="Firstname" Type="PartyDetail_0"/> 

?> may request <?SpeedLegal <lnsertReusablePhrase 
IDREF="PaidOrUnpaidLeave" LogicSource="LogicSource_1"/>?> by filling In a request 
15 forni at least one month prior to ihe earliest date requlred.</p> 
<p> 

<?SpeedLegal <ConditiC)n IDREF="AmountOfLeave.negotiate" 
LoglcSource="LoglcSource_1"/>?>The amount of leave is negotiated with the 
employee.</p> 

20 <p> 

<?SpeedLegal <Condition IDREF="AmountOfLeave.award" 
LogicSource="LogicSource_17>?>The amount of leave is determined according to the 
relevant award.</p> 

<p>The employee has the following leave entitlements: <object> 
25 <table> 

<tbody> 
<tr> 

<?SpeedLegal <Repeat ID="NumberOfLeaveTypes7>?> 
<td><?SpeedLegal <lnsertUserText IDREF="LeaveType7>?> 

30 <\d> 

<td><?SpeedLegal <lnsertUserText IDREF="LeaveAmount7>?> 

</td> 

</tr> 
</tbody> 
35 </table> 
</object> 
</p> 

<?SpeedLegal 

<SmarlI\/lodule uri=7home/iml/tennination.sm" 
40 version="/history/SmartRepo8itory/1 0/1 .5"> 
<PartyMapping> 

<PartyMap From="Contractor" To="Employee"> 

<PartyDetailMap From="Shortname" To="Firstname7> 
<PartyDetailMap From="Fullname" To="Fullname7> 
45 </PartyMap> 
</Partyl\/lapping> 
</SmartModule> 

?> 

</LetterBody> 
50 <LetterTail> 
<Closing/> 
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<Sender/> 
</LetterTail> 
</Letter> 

5 The StartDate variable, which is defined in the LogicFile example above as a SimpleDate, 
is inserted into the document via an InsertUserText processing instruction. 

The XML docimient example above also demonstrates how versioning is implemented in 
this alternative embodiment. There is a "version" attribute on the LogicSource element 
10 indicating that this document requires a particular version of the logic resource identified 
by the *W attribute. This method for identifying resources and versions of resources is 
consistent with the DeltaV standard for version control, as described at 
http://www.webdav.org/deltav/ . The 'Version" attribute is also present on the 
SmartModule. 

15 

Versioning offers a number of advantages to the system, includiug the ability to 
incrementally change, rollback and record differences between versions of a document. 
When a new version is created, the author is prompted to supply information relating to the 
changes made. If a more recent version of a LogicSource or a Module is available, a user 

20 can update to the newer version of the resource (if compatible). Compatibility is 
determined by checking that all references in the document to the old version will be 
resolved by the new version. This creates the possibility for LogicSources and Modules to 
be maintained independently of documents that refer to them. Versioning avoids the 
possibility of logical iaconsistencies. These can occur where a shared LogicSource is 

25 modified such that not all Variables can be resolved. Since a given document can only ever 
point to a particular version of a LogicSource or Module, this is never possible. Finally, 
versioning creates the option for *pubUshing' a particular version of a document to users 
while the document continues to be developed. Some users may be restricted to only being 
able to access these 'published' or £^proved documents. 

30 

A standard XML editor designed purely for editing XML documents only needs to concern 
itself with the docimient granmiar, flie user interface, and the XML document. In contrast. 



wo 03/075191 



PCT/AU03/00253 



-52- 

the editor 112 of the document assembly system perfomis standard editing functions but 
also: 

(i) defines and manipulates logic in logic sources 210 according to the logic grammar 
214; 

5 (ii) refers to and manipulates references to logic sources 210 within XML source 
documents 208. This involves recognising the Processing Instructions described 
above and handling them as if their PI data were *real' XML elraaents in the XML 
source document 208. It also includes ensuring that all of the logical interactions 
between a logic source 210 and the XML source Document 208 are *valid'. To do 

10 this, the editor 1 12 treats the source document 208 and the logic sources as if they 

were a single docxmient, so that, for example, the IDREF in a Condition 
Processing Instruction to a Condition ID in a logic source can be validated; and 
(iii) presents a user interface to the user that allows an XML source document, logic 
soiurce and logic references within an XML source document to be easily 

IS manipulated. 

As shown in Figure 12, tiie process of generating input files with the editor 112 of ttie 
document assembly system typically includes XML source document (without logic) 
creation and editing at step 1202, logic souarce content creation and editing at step 1204, 
20 and then creation and editing of logic references within the XML source document at step 
1206. 

Figure 13 is a screenshot of a window display generated by the editor 112 during editing of 
a source XML document representing a letter. The window display includes a pull-down 

25 menu toolbar 1302, an icon toolbar 1304, and a document window 1306. The document 
window 1306 is vertically divided into a structure portion 1308 on the left and a detail 
portion 1310 on the right The stracture portion 1308 is itself vertically divided, with a 
hierarchical display 1312 of the XML elements of the document on the left, and an 
abbreviated description display 1314 of each element on the right The detail display 1310 

30 includes text boxes 1316 to 1322 for displaying and entering XML elements and textual 
content Pull down menu buttons 1324 to the left of each text box 1316 to 1322 allow the 
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inseition of XML elements and processing instructions. To insert elements or processing 
instructions within a body of text, the user can biing up a menu of allowable insertions by 
either using the mouse (right-clicking) or a key combination. This will insert the element 
or processing instraction within the text at the current position of the cursor. The presence 

5 of a condition processing instruction associated with the content of a text box is indicated 
by the presence of a red dot on the corresponding puU down menu icon 1324. An orange 
dot on the icon 1324 denotes a Note. Thus in Figure 13 the first text box 1316, third text 
box 1318, and the fourth text box 1320 represent conditional text elements that may or 
may not be included in an instance document generated firom this source document being 

10 edited depending upon the value of the condition associated with each text element. The 
second text box 1322 has a note that does not form part of the text of the instance 
document but is viewable in HTML and PDF renderings of the instant document, as a pop- 
up window, for example. 

15 Figure 14 is a screenshot of the editor 112 window display after definition of a multiple 
choice question. The variable associated with this question is named EmpIoyment_type, 
and three conditions, Employment_type.Casual, Employment_type.PartTime, and 
Employment_type.FullTime indicate whether an employee is employed on a casual, part- 
time, or full-time basis. A second mxdtiple choice question, AmountOfLeave, is also 

20 shown, with associated conditions AmountOfLeave.negotiate and AmountOfLeave.award. 
These conditions can be used to select the appropriate text for inclusion in an instance 
document depending upon the values of these variables, which are determined by 
responses received firom a user or some other data source, as described above. 

25 Figure 15 shows a screenshot of flie editor 112 window display during definition of the 
question associated with the AnnountOfLeave variable described above. An ID text box 
1502 allows the user to enter the ID name of the question, and a question text box 1504 is 
provided for tiie user to enter the actual text of the question that will be presented to the 
user. Note tiiiat, in this case, a party reference is included in the question text so that the 

30 employee's first name can be included in this text when it is displayed to an end-user. A 
pull down menu 1506 allows the user to specify whether the default answer to this question 
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should be determined on the basis of a bias favouring a particular party, for example, 
employee or employer, or a predetemiined default value. In this case, a bias has been 
selected, and consequently a bias button 1508 is displayed for each possible response to the 
question. A bias button 1508 is used to specify the degree to which the corresponding 
5 answer suits a particular party. If, during an interview round, an end-user specifies that the 
selected party is to be favoured, then the default answer to that question will be the one 
which best suits the selected party. This mformation, including bias and/or fixed default 
information, is included in the SelectionCriteria element associated with each response. 

10 A prompt text box 1510 is provided for editing each possible response (as it will be 
presented to the user) to this multiple choice question. Value text boxes 1512 allow the 
user to enter a variable value associated with each response. For example, if the award 
entitlements response was selected by a user, the MultipleChoiceQuestion or variable 
AmountOfLeave would have value "award", and the related conditions 

15 AmountOfLeave.award and AmountOfLeave.negotiate would have a values of trae and 
false respectively, "Add notes'* buttons 1514 are provided for each response, allowing the 
user to add note text which can be displayed during the corresponding interview to assist a 
user to select the appropriate response. 

20 Within the editor 1 12, the user may also need to be able to reuse a chunk of XML with its 
associated logic. A reusable chunk of XML is referred to as a Module. 

A Module comprises: 

(i) the XML element or text the user has selected; 
25 (ii) external-items (that is, items in the document but outside the text selected by the 
user tiiat are referred to (genially by ID) by that text or by a reference firom that 
reference and so on); and 
(iii) a LogicSources element declaring logic required by (i) and (ii). 
To make a Module available for re-use, the editor 1 12: 
30 (i) exports the element or text the user has selected; 
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(ii) identifies and possibly exports external-items, such that the entire module is able 
to be made valid once it has been imported into a target docimient; and 

(iii) identifies all logic that the module references and ensures that that logic is in the 
logic sources declared in the Module's LogicSources element. 

5 

There are two ways that a user may desire the module to be used. In the first, a copy of the 
module is imported into die document - this allows the author to modify the text and/or 
logic as the module now forms part of the target document For a module copy, the editor 
112: 

10 (i) imports the text - ensuring that it is valid in the target document. This may mean 
altering identifiers to allow the import to occur; 
(ii) imports or ensures that any external-items specified in the module are present in 
the target document. This may mean altering identifiers to allow the import to 
occur ; 

15 (iii) ensures the presence of (importing into a logic source used by the target document 
if necessary), all associated logic referred to by the text, external-items or from 
within the logic itself. This may mean altering identifiers to allow the import to 
occur ; and 

(iv) maps any Party references (if possible) in the text, logic and external-items to 
20 those used in the target document. 

Altematively, the user can import into the document a link to the module - tins can point 
to a current v^ion of the module, and any modifications subsequently made to the module 
are automatically reflected in the resulting document. For a module Unk, die editor 1 12: 
25 (i) creates a SmartModule processing instruction in the target document (which links 
the module to the target document) - ensuring that it would be valid if present in 
the target document. This can include providing a map of identifiers that need to 
change in order to allow the import to occur; 

(ii) displays the module to the user so that the text can be viewed (but not edited) as if 
30 it were part of the target document; 

(iii) ensures tiiat any extemal-items required by the module are presmt in the target 
document (adding tiiem if necessary); 
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(iv) adds logic sources required by the module to the target document LogicSources; 

(v) provides party mapping (if possible) so that the module can be imported into the 
target document; 

(vi) provides a means by which identifiers (declarations and references) in the module 
can be kept track of such that the target document caimot be invalidated when the 
module is imported into the target document by the Processing Engine 202, The 
editor 112 tracks all identifiers used in the XML document including linked 
Modules without having to import or fetch the Module every time. This is 
achieved by: 

(a) keeping references to logic made from the linked Module; 

(b) keeping references to links between Module elements and elements 
defined in the XML document; and 

(c) keeping references to declarations made within the linked Module, 

In some circumstances, it may be desirable to ensure that an instance XML document can 
be generated which conforms to the same grammar as the source document, for example, if 
the XML instance document is to be used outside the document assembly system (for 
example, edited in a standard XML editor). 

If it is possible to place conditions on any element in the source XML document, then there 
is no guarantee that the instance XML document will be valid. 

As an example, suppose the DTD (xhtml-letter-v2) used for the letter document above 
specified that a <letter> must have one and only one <LetterHead> child. Then, if a user 
were able to place a condition on the LetterHead, and in processing the source document 
through the Processing Module 202 that condition evaluated to false, the <LetterHead> 
child would be omitted from the instance XML document, with the result that the instance 
XML document would be invalid. 
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XML granunars can express a variety of restrictions on the number of occurrences that are 
allowed for particular elements, for example zero or one, exactly once, and one or more 
times. If an instance document does not match a specified rule, it will be invaUd. 

5 To ensure that the instance XML document is valid, a condition PI can only be attached to 
an element if: 

(i) the element is allowed zero or more times; or 

(ii) the element is allowed to occur zero or once; or 

(iii) the element is allowed to occur one or more times, and either: (a) one of the 
10 occurrences of the element does not have a condition attached, or (b) one of the 

conditions is always true when the others are false. 

In order to express more than one alternative for an element that is only allowed to occur 
zero or one times, one condition is applied to the element itself to determine whether the 
15 element spears at all in the instance XML document, and alternative condition Pis are 
appUed to nodes inside the element (the same rules apply to the use of conditions on these 
nodes). If an element is to occur exactly once, and it is desired to allow several 
possibilities for its textual content, then conditional phrases are used inside the element - 
the editor 1 12 prevents a condition &om being attached to the element itself. 

20 

Similarly, if an XML document contains an element with an ID, and another with an 
IDRBF which points to it, then, if the element with the ID had a condition on it which 
evaluated to false, with the result that that element was not included in the instance XML 
document, and the element with the IDREF was included, the docxmient would be invalid. 

25 

Accordingly, if the instance XML document is to be vaUd, tiien any element with an 
attribute of type IDREF is subject to conditions that include all the conditions to which the 
element with the corresponding ID is subject. Whenever the conditions to which an 
element with an ID is subject are altered, the editor 112 ensures that all elements with an 
30 IDREF pointiag to it are subject to ^propriate conditions. 
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Afler a source document 208 and its one or more logic sources 210 have been defined with 
the editor 112, they can be used by the processing engine 202 to generate one or more 
instance documents. The processing engine 202 begins processing an input XML 
document 208 when the Java controller servlet 218 creates an instance of the evaluator 402 
5 in response to a request &om the user's web browser. In the preferred embodiment, the 
constructor for flie evaluator 402 takes the input XML document as a document object 
model (DOM) object, but it could alternatively be passed as text, or as a URI fi-om which it 
can be retrieved. 

10 Later, the Evaluator 402, in conjunction with the evaluable node package 404 and the 
parties package 406, identifies questions that need to be answered. In order for it to be 
able to suggest a default answer or answers for each question which would result in text 
intended to favour one party to the document over another (or to automatically answer a 
question that is not a KeyQuestion), the Java servlet 218 may specify to the Evaluator 402 

1 5 which party to favour, as ascertained at step 504. 

The Evaluator 402 constructs two objects it will need later: operativeConditions, and 
operativelnterviewltems. It also extracts the logic firom each logic source referred to in the 
document's LogicSources elraaent, and &om each logic source referred to in the 

20 LogicSources elements in each logic source, and so on (being careful not to get into an 
infinite loop). However, in the preferred embodiment, the Evaluator 402 does not extract 
the logic fi-om a logic source imported by an XML fragment until the SmartModule 
processing instruction is encountered later. When the logic import is performed, the 
Evaluator 402 determines how the parties in that logic source are mapped, relative to the 

25 tnfliTi XML document (flie party m^ing chain). Each Condition and Interviewltem (e.g., 
MultipleChoiceQuestion and UserText(Juestion - there are no ArrayRowIterators in a logic 
source) is stored in a hash table keyed by the URI of its logic file combined with its party 
mapping chain and its own ID, so that discrete instances (as explained above) can be 
stored, and they can be retrieved efficiently. 

30 
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Finally, the Evaluator 402 extracts Party declarations from these logic sources, creates a 
Party object to represent the Party declaration, and stores each Party object in the Parties 
object of the party package 406, keyed by the URI of its logic file combined with the ID of 
the Party. Each Party object has objects associated with it representing each PartyDetail, 
5 and each PartyDetail has a means of represCTitiag each Value in it The Value element is 
stored in an object named PartyDetailValue. 

The invokmg process (the Java Controller Servlet 218) then calls 
evaluator . initialisePartiesInUse 0 . The purpose of this method is firstly, 

10 to identify any UserTextQuestions in a Party XML object that will definitely need to be 
answered (/.a, irrespective of whether any conditions in the document evaluate to true or 
false), and secondly, to identify the Party XML objects for which the engine will need to 
know a gender and/or number. It is desirable to estabUsh this up firont, so that for an 
invoking process 412 which interacts with an end-user, the questions relating to the parties 

15 can be put to the user before the other questions. One of the benefits of doing this is that 
words in those oflier questions fliat identify a party by using a PartyReference can be 
replaced with the value of that PartyReference. 

The method evaluator . initialisePartiesInUse () performs a breadth-first 
20 traversal of the DOM object. The breadth-first traversal is implemented recursively; 
recursion stops at any node that has a condition attached to it. Where in the course of 
performing the breadth-first traversal, a PartyReference PI is encoimtered, getValue is 
invoked on the appropriate PartyDetail. That method is as follows: 

25 public String getValue ( Evaluator evaluator ) 

throws SpeedLegalLogicException { 

if (value !=null) { 
return value; 

30 } 

boolean retumEarly = false; 

String number = party . getNumber () ; 
35 String gender = party . getGender {) ; 
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if ( gender==null ) { 

if ( needToKnowGender ( ) ) { 

5 // Ask the user the gender question 

party. askGender(evaluator) ; 

retumEarly « true; 
} else { 

10 // If we don't know it and don't need to know it, 

// because the only value provided is for 

"xinspecif ied" 

gender = "Unspecified" ; 

} 

15 } 

if ( nutnber==null ) { 

if ( needToKnowNutnber ( ) ) { 

20 // Ask the user the number question 

party. askNutnber(evaluator) ; 

retumEarly = true; 
} else { 

25 number = "Unspecified"; 

} 

} 

if (retumEarly) { 
30 return null; 

} 



35 



45 



// If we get here, we're" guaranteed some value for both 
gender and number 



//Is there an exact match on gender and number? 
String key = PartyDe tai lvalue, cons true tKey( gender, 

number) ; 

40 if ( values. get ( key ) I=null ) { 

value = { { PartyDe tai lvalue ) values . get ( key 
) ) .getValue( evaluator ) ; 

return value; 

} 



// Failing that, fall back to partial matches in some 
circumstances . 



50 // Match on Gender first, but could do Number first 

if we wanted. . 
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// GENDER 

// if we wanted to prohibit match on Unspecified number 

whenever there 

// was a value for either but not both Singular and 

5 plural, we'd 

// have if IneedToKnowNumber () here..- 

key = PartyDetailValue .const rue t Key ( gender, 

"Unspecified") ; 
10 if ( values. get ( key ) l^null ) { 

value = ( (PartyDetailValue) values. get { key 

)) .getValue( evaluator ) ; 

return value; 

} 

15 

// NUMBER 

//if ( ineedToKnowGender 0 ) { - see comments on Gender 

aJDOve 

key = PartyDetailValue. const2nictKey( "Unspecified", 

20 number) ; 

if ( values. get ( key )!=null ) { 

log.debug( "Partial match on number."); 
value = (( PartyDetailValue) values. get ( key 
)).getValue( evaluator ); 
25 return value; 

} 



// What about a match on completely unspecified? 
30 //if ( IneedToKnowNumber 0 && IneedToKnowGender () ) { 

log. debug ("Trying to match unspecified number and 

gender . " ) ; 

key = PartyDetailValue. constructKey( "Unspecified", 

"Unspecified") ; 
35 if ( values. get ( key ) l=null ) { 

log . debug ( "Match ' on default only . . " ) ; 

value = (( PartyDetailValue) values. get ( key 
)).getValue( evaluator ); 

return value; 

40 } 

//We could get here if the document author didn't provide 
Unspecified number 
45 // and Unspecified gender, but only, say Female Singular, 

// and the end user chose say Male Singular, 
log. error ("No match, not even on Unspecified."); 
value = " [* No match for party: " + party . getKey ( ) + " , 
detail: " + id 

50 + " , of gender ' " + gender + " ' and number 

+ number + "'. Document author must fix this. *]"; 
return value; 



1 11 
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Where necessary, by invoking other metiiods, getValue causes Interviewltems to be 
created which represent the questions that need to be answered. The questions are either 
5 MuIfipleChoiceQuestions that seek to establish the Gender (Male, Female or Neuter) or 
Number (Singular or Plural) of a Party, or Usert*extQuestions that prompt for text forming 
part of the value of the PartyDetail for the matching Gender and Number (where 
'matching' is determined by the procedure implemented by the getValue method). 

10 When the Evaluator 402 has finished doing this, the kivoking process 412 checks to see 
whether there are any Interviewltems that need to be resolved. If there are no 
Interviewltems that need to be resolved, Evalxiator.evaluateQ is invoked. It extracts any 
Interviewltems firom the document which need to be resolved at this point. Its function is 
described in detail below. 

15 

If there are still no interview items that need to be resolved, then the input document is a 
trivial case, and the instance XML document would be identical. Otherwise, the invoking 
process 412 resolves tihie interview items. 

20 The Java controller servlet 218 creates an HTML form for a user to complete in their web 
browser. However, it will be apparent that the controller servlet 218 could alternatively 
seek responses firom some other source, for example, a database which it queries using 
SQL, a web service, or some application using its APL As described above, a logic source 
can specify a preferred method for resolving either all interview items, or some particular 

25 interview item, together with the details required in order to do so (e,g., URL, 
authentication information, query etc) which the invoking process 412 attempts to honour. 
The invoking process 412 returns a response for each interview item, even if it couldn't get 
a response using the preferred method. 

30 Having resolved the interview items, the invokmg process 412 calls Evaluator 4 02 ' s 
evaluate ( ) method, passing it a set of interview items that contain values. 
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evaluate ( ) first transfers the answers from the interview items proffered by the 
invoking process 412 to any matching interview items for which it was awaiting responses. 
Because there is a flag on each PartyDetail and each Condition object which ensures that 
the Evaluator 402 only attempts to evaluate it once each time the invoking process 412 
5 calls Evaluator 402 's evaluate () method (hereinafter called "interview 
round"), these flags are reset. 

As described above, the Evaluator 402 performs a recursive breadth-first traversal of the 
DOM object. During the course of the breadth-first traversal, certain nodes will be 
10 encountered that require special handling. In this embodiment, these nodes are all 
processing instructions so that they can be included in an XML document without affecting 
its validity. 

PartyReference processing instructions are treated as described above. It is possible for 
15 the Evaluator 402 to encounter a PartyReference to a PartyDetail not previously 
encountered (because it occurs below an element to which a condition is attached). As 
before, getValue is invoked on the appropriate PartyDetail. 

It will be apparent that in embodiments of the present invention, any node could be given 
20 special handling - either by node name, or node type, in either all documents or only 
documents using a specified XML schema or DTD, or indeed by position in the document. 
In the preferred embodiment, the traversal method calls an empty method which can be 
overridden in a subclass of Evaluator to implement this special handling if desired. 

25 When a node that has a condition processing instruction is encountered, the Evaluator 402 
attempts to evaluate it First, it looks to see whether that condition has been encountered 
already (if it has, an object representing it will be stored in the operativeConditions object). 
If the condition has not been encountered already, an object that represents it will be 
constructed and stored in the operativeConditions object Then, if the condition is not fidly 

30 evaluated, and if the relevant flag indicates that no attempt has been made to evaluate the 
condition in this interview round, the Evaluator 402 attempts to evaluate the Condition. 
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The Condition is evaluated as follows. Each of the elements that can appear in a Condition 
- tiie operators And, Or, Not, Test, UseCondition, and the values True and False - 
implements an interface that defines a method named evaluate© (not to be confused with 

5 Evaluator 402 or its evaluateQ method), and has a constructor with the same signature. 
Because of this, in this embodiment, the Condition object can use a Java programming 
technique known as reflection to constract objects representing its children, and call theur 
evaluateQ method. Jn turn, if a child of an object is And, Or, Not, Test, or UseCondition, 
the objects can recursively construct and call evaluateQ on an object representing that 

10 child, so that ultimately, each of And, Or, and Not, has arguments that are boolean values 
that can be evaluated to true or false using classical boolean logic. Finally, Condition(True) 
evaluates to Tme, and Condition(False) evaluates to False. 

If a Test node is encountered, tiien when its evaluateQ method is invoked, the Test object 
15 checks to see whether the MultipleChoiceQuestion it refers to has been mstantiated as an 
object (it will have been if some other Test node which refers to the same 
MultipleChoiceQuestion has akeady been processed). If the MultipleCliolceQuestion has 
not bem instantiated, a MultipleChoiceQuestion object representing it is constructed. 

20 If the invoking process 412 has indicated that only Key Questions should be asked, and 
this question is not a Key question, then the processing engine 202 can evaluate it 
automatically using the scoring procedure based around the SelectionRules and 
SelectionCriteria for that MultipleChoiceQuestion (in this embodiment, a method in the 
object representing the MultipleChoiceQuestion in the interview item package 408 does 

25 this). Where a new MultipleChoiceQuestion has been constructed, it will be added to 
operativelnterviewltems. Each Interviewltem (a MultipleChoiceQuestion is a type of 
Interviewltem) in operativelnterviewltems has status either "pending" or "known". 

If a MultipleChoiceQuestion has status pending, then tiie Evaluator 402 waits for the 
30 invoking process 412 to provide it with a response value before it evaluates the Test that 
uses it to true or false. Interviewltems with status pending are not retumed to the hivokmg 
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process 412 as they are created, but rather, are only returned when the traversal has been 
completed. This makes it easy for an invoking process 412 that interacts with a user to put 
several questions to the user at once, perh^s organised by the value of the 
MultipleChoiceQuestion's Topic child. 

5 

If the MultlpleCholceQuestion has status known, tihen Test's Evaluate method will return 
true if the MultipleChoiceQuestion has a response eqiial to the value specified in flie Test, 
and false otherwise. 

10 If the condition evaluates to true, then the traversal can descend into the node to which the 
condition applies. If it evaluates to false, that node will not be included in the instance 
XML document (To assist the rendering eaigine 204 later on, the evaluate method of the 
Evaluator 402 adds an attribute named "diedlnEvaluation" to an element that had a 
condition which evaluated to false.). If the condition cannot be evaluated to either true or 

15 felse, the traversal does not in this interview round descend into the node to which the 
condition applies, histead, any pending interview items (created as described above) will 
in due course be returned to the invoking process 412 for resolution, so that, assuming 
responses are provided, the condition may be evaluated in the nract interview round. 

20 When an InsertReuseablePhrase processing instruction is encountered, the Evaluator 402 
retrieves the ReusablePhrase node it refers to from the relevant logic source, and 
physically rqilaces the processing instruction node in the DOM object with that 
ReusablePhrase node. It then puts an IDREF to that logic source on relevant descendants 
of the ReusablePhrase node, and converts any logic elements in those descendants from 

25 the XML format used in the lo^c file to the Processing Instruction format appropriate to 
the XML source document. It is then possible to traverse the descendants of the 
ReuseablePhrase node in the usual way, albeit in a context provided by the party mapping 
chain for the logic source it came from (so Conditions and Interviewltems can be looked 
iq) correctly). 

30 
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A consequence of this way of processing an InserlReuseablePhrase processing instraction 
is that a single ReusablePhrase node is mserted into the document and traversed multiple 
times if there is more than one InserlReusablePhrase processing instruction that points to 
it. In an alternative embodiment, each ReusablePhrase node could be traversed just once, 
5 and the result inserted into the document at a lata: step. 

When an InsertUserText processing instruction is encountered, the Evaluator 402 
determines whether a UserTextQuestion object representing the UserTextQuestion the 
processing mstruction points to already exists in operative I nterviewltems. If it does not, 
10 the Evaluator 402 creates a new UserTextQuestion object, and adds it to 
operativelnterviewltems with status "pending". 

When an ArrayRowlterator element is encountered, the processing engine 202 first checks 
to see whether its "repeat" attribute has a known positive mteger value. If it does not, then 

15 the ArrayRowlterator cannot be processed any further until the hiterviewltem named in that 
attribute has a value (it is an error if that value is not a positive integer). Once the "repeat" 
attribute has a known positive integer value, a two-dimensional array of hiterviewltems is 
CTeated. The first dimension is the Interviewltems identified in the ArrayReference 
processing instruction descendants of the parent of the ArrayRowlterator; the second 

20 dimension is the number of rows specified by the "repeat" attribute. The 
ArrayRowlterator object containing that two-dimensional array of interview items is added 
to Operativelnterviewltems, and resolved in the usual way. 

A situation can arise whereby two ArrayRowlterator processing instructions contain 
25 An^yReference processing instructions pointing to the same interview item. For example, 
suppose a first ArrayRowlterator has a repeat attribute value of nl, and the second n2. In 
the preferred embodiment, the Interview Items in the abs(n2-nl) rows common to both 
ArrayRowlterators are then asked only once. However, alternative embodiments could 
require independent values for the Interviewltems in those rows. 

30 
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When the breadth-first traversal is complete, the evaluate method of the Evaluator 402 
returns control to the mvokmg process 412. The invoking process 412 then asks the 
Evaluator 402 for all operatlvelntervlewltems fliat have status pending. If there are none, 
then the document has been fully evaluated, and an instance document is created by the 
5 Rendering Engine 204. If there are operativelnterviewltems with status pending, the 
invoking process 412 determines a response value for each of those interview items, as 
described above following evaluator . init ialisePartiesInUse ( ) . 

Having resolved the interview items, the invoking process 412 calls evaluate method 
10 of Evaluator 402, passing it a set of interview items which contain values. This 
cycle repeats, until such time as there are no pending interview items. 

When there are no pending interview items, an instance document in XML, PDF, RTF, 
HTML, or some other format, can be created firom the DOM document object which the 
IS processing engme 202 has bem manipulating. 

As the rendering engine 204 creates an instance document, elements of the source XML 
document with conditions that evaluated to false (and therefore had an attribute named 
"diedlnEvaluation") are omitted, each Ins^rtUserText processing instructions is replaced 

20 by the value of the corresponding UserTextQuestion, the ReusablePhrases have replaced 
the InsertReusablePhrase processing instructions, and so on. This is done using XSLT 
with Xalan extension functions, which get the values of UserTextQuestions and 
PartyReferences frdm the evaluator 402. In alternative embodiments, an extension 
function could look up the value of the condition, instead of relying on the presence or 

25 absence of the diedlnEvaluation attribute. An alternative to using XSLT for most of the 
rendering engine's work would be to progranunatically do another recursive traversal. 

Of particular interest is the generation of an instance docxmient into HTML format. The 
instance document can be rendered in such a way that any text that appears as a result of 
30 one or more conditions evaluating to true, or as a result of a response to a 
UserTextQuestion, is generated by the rendering engine 204 as a hypertext anchor. When 
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that anchor is activated, the user interface displays the question and response that resulted 
in the anchor text being included, as described above. In the case of text that is subject to 
one or more conditions, it would be possible to display the questions associated with each 
condition. However, in the preferred embodiment, only the questions associated with the 
5 closest ancestor having a condition processing instruction are displayed. 

When the anchor is activated, it is also possible to reset one or more of the questions 
associated with the condition (which mesms the condition should be re-evaluated, so that 
the question is asked again), or, in the case of a UserTextQuestion, to ask it again. Where 
10 a question associated witii a condition is reset, any other condition which used that 
MultipleChoiceQuestion is also reset, as is any other condition which used that condition, 
and so on. 

In tiie user interface available to a user of the document assembly system via their web- 
15 browser, when a user moves their mouse over the relevant text, JavaScript and the anchor 
element's HTML onMouseOver event is used to generate a pop-up wmdow displaying the 
relevant questions and responses, as shown in Figure 7; when a user clicks on the anchor, 
the Processing Engine 202 is invoked to reset the relevant questions. 

20 The HTML rendering of the document also typically provides a list of all the questions that 
were answered, together with the user's responses. If the user selects a question link, the 
Processing Engme 202 resets that question as described above. 

Many modifications will be apparent to those skilled in the art without departing firom the 
25 scope of the present invention as herein described with reference to the accompanying 
drawings. 



